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PREFACE 


This third volume of the Practical 
Microcomputer 
Program- 
mingrMseries is concerned with detailed assembly language program- 
ming procedures for the Z80®microcomputer manufactured by Zi- 
log, Inc. of Cupertino, California. Its purpose is to provide the read- 
er with the necessary information and software tools to make effec- 
tive use of the Z80. The software, an assembler and debugging moni- 
tor, is given in full source form in appendices, and the purchaser of 
this book.will be granted license to make copies for his personal or 
academic, but not commercial, use when the coupon at the back of 
the book is fully filled out and returned. To save the tedium of re- 
transcribing the programs, paper tape object copies of both assem- 
bler and debugging monitor will be sent to the purchaser at no fur- 
ther cost upon receipt of the filled out coupon. 
From one viewpoint or another every computer design contains 
flaws or features which might be viewed as awkward. The Z80 is no 
exception to this. Its weak points notwithstanding, a detached ob- 
server must conclude that, from a programming point of view, the 
Z80 is the most powerful eight bit microcomputer yet to appear. De- 
signed as a superset of its popular predecessor the 8080, it offers en- 
hancements over the 8080 which remove almost all of the objections 
to the programming characteristics of the earlier machine. It has a 
flexible, powerful instruction set which allows it, in skilled hands, 
to perform tasks of any significant size and complexity in substan- 
tially less memory than competitive microcomputers. With a single 
minor exception, its binary instruction set is a superset of the 8080's, 
which allows software developed for the 8080 to run unchanged 
on the Z80, an important consideration when contemplating a ma- 
chine upgrade. 
Having produced this powerful device, capable of exploiting the 
useful programming features of the 8080 and circumventing the 
clumsy ones, Zilog took the surprising step of making the Z80 com- 
pletely incompatible with the 8080 at the symbolic level. A bizarre 


and verbose language was chosen to describe the machine in manu- 
facturer's 
literature. 
While this language has undoubted 
merits in 
terms of similarity to formal notation used in system software de- 
sign, there are overpowering objections to it from the point of view 
of applications programming. 
What makes a good formal design no- 
tation does not make a workable programming language. The needs 
of the two environments 
are completely 
different. 
Further, 
this 
choice of language voids the body of expertise built up so slowly and 
painfully with the 8080, forcing Z80 users to undergo a completely 
unnecessary and wasteful relearning task. Finally, as practical objec- 
tions, the language requires about a third again as many keystrokes 
per line as conventional languages, and processors capable of assem- 
bling this language are not generally available. The consequence of 
this last fact is that most small system users are employing the Z80 as 
an 8080, the increment in power going mostly unexploited. 
It can be argued that the language specified by the hardware man- 
ufacturer 
forms in some sense a standard. 
In a field of arbitrary 
"standards" 
the manufacturer's 
arbitrary 
"standard" 
might be 
considered the least arbitrary. 
The originator 
of the hardware has 
the right to describe it in any terms he sees fit. Still, if one chooses to 
send a shipload of Swahili bibles to Sweden, one ought not to be as- 
tonished if the books do not rivet the attention of the Swedes. 
In a practical way, the real standard 
is that which exists, that 
which is already in common use and with which the largest number 
of potential users is already familiar and comfortable, 
Le., the lan- 
guage of the 8080 family machines. Arguments can be made, many 
valid, that this language is a hodgepodge of different notations hav- 
ing very little internal consistency. So does the English language, but 
it is a useful, flexible tool, and attempts to replace it with something 
closer to the heart's desire of a grammarian would be foolish, as Es- 
peranto proponents have found out. 


Obviously the greatest service to the greatest number of users and 
potential users of the Z80 can be performed by allowing the machine 
to be programmed 
in a language compatible with that of the 8080. 
For this reason the language chosen for use in this book is an exten- 
sion of the 8080 language, and the assembler in appendix B processes 
this extension. Using this system, those familiar with the 8080 can 
continue to program in the language with which they have become 
comfortable, 
extending their expertise into the Z80 superset as they 


master each new class of instructions. 
The choice of language is 
therefore entirely pragmatic. A cross index of the mnemonics used 
here with those of Zilog is supplied in appendix D. 
The assembler will run on any 8080 family or Z80 machine, being 
written entirely in the 8080 subset. A Z80 based machine is not re- 
quired. The program requires somewhat less than 10K RAM, the 
precise amount depending on the length of the user supplied input/ 
output routines. It will process source text into object code at about 
1000 lines per minute on a system running at 2MHz. As some readers 
may wish to make changes in the assembler, the methods used in it 
are the simplest possible, at the cost of some space and speed. While 
no program of this length and complexity can be certified to be free 
of error, the assembler and debugging monitor have been subjected 
to extensive use and testing and contain no known errors. If any are 
discovered by readers, either in the software or the text, the writer 
would greatly appreciate being informed so they may be corrected in 
future printings. 
Suggestions for improvements 
and additions 
are 
also welcome. 
A number 
of individuals 
and organizations 
have contributed 
to this book, either through discussions and suggestions, testing and 
criticism 
of 
software 
or 
provision 
of 
materials. 
They 
are, 
alphabetically: 


Mr. Ralph Hayford 
Mr. Guy Hobart 
Mr. Larry Leske 
Mr. Harvey Nice 
Mr. William Powers 
Mr. Harold Scoblow 
Mr. Albert Shatzel 
Mr. Ted Singer 
Mr. Mel Thomsen 
Victor Comptometer Inc., Components Division 
Mr. Karl Weller 
Zilog, Inc. 


Jf': Weller 
Chicago 
July 1978 


1 I 
THE NATURE OF THE 
PROGRAMMING 
TASK 


"The idea of non-human 
devices of great power and great ability to 
carry through a policy, and of their dangers, is nothing new. All that is 
new is that now we possess effective devices of this kind. In the past, si- 
milar possibilities were postulated for the techniques of magic, which 
forms the theme for so many legends and folk tales. In all these stories 
the point is that the agencies of magic are literal-minded; and that if we 
ask for a boon from them, we must ask for what we really want and not 
for what we think we want. The new and real agencies of the learning 
machine are also literal-minded. 
If we program a machine for winning 
a war, we must think well what we mean by winning. We can fail in this 
only at our immediate, utter, and irretrievable peril. We cannot expect 
the machine to follow us in those prejudices and emotional compro- 
mises by which we enable ourselves to call destruction by the name of 
victory. If we ask for victory and do not know what we mean by it, we 
shall find the ghost knocking at our door?' 


Norbert Wiener 
Cybernetics 
1948 


To say that programming 
is a difficult 
activity is to utter a plati- 
tude. 
The great 
amount 
of literature 
and diverse 
opinion 
about 
methods and languages are testimony enough to the exact and exas- 
perating 
character 
of an activity which is almost never performed 
correctly the first time. It is the purpose of this introductory 
chapter 
to attempt to explain to the reader why this is so, and by so explain- 
ing to help him avoid some of the pitfalls inherent in the task. 
If the essence of the problem has to be condensed into a single sen- 
tence, the sentence would read something 
like this: programming 
computers is an alien psychological 
task. It is communication 
of a 
sort, but of a sort to which our associative mental processes are bad- 
ly adapted. 
Learning to do it can be compared in some ways to learn- 
ing a foreign language. 
It involves a vocabulary 
and a set of rules 


which must simply be memorized, 
along with the exceptions 
to the 
rules. When this has been accomplished 
a long and tedious period of 
practice 
follows, involving bungling and false starts. This period of 
practice 
leads by small increments 
to fluency in the use of the new 
language. 
If a second foreign language is to be learned the task is a 
bit easier, since some of the knowledge is "portable". 
Similarities 
in 
structure 
and vocabulary 
are noted and remembered, 
these similari- 
ties working as "bootstraps" 
in beginning with the new language. 
The similarity ends here, however. Learning a foreign language is 
simply learning an alternate 
form of human communication. 
While 
the various 
forms 
of human 
communication 
look very different, 
they are really much more similar than different. 
The nuclear ideas 
of human communication 
are universal, 
concerned 
as they are with 
things 
which concern 
the human 
beings using the communication 


system known as language. 
Fundamental 
to human communication 
is the notion 
of implication, 
e.g., the remark 
by a Soviet politician 
that leaving the West to police itself in certain matters 
was "leaving 
the goat to guard the cabbage". 
Mr. Khrushchev 
did not have to say 


that he distrusted 
the West; the implied parallel with the goat and the 
cabbage did it for him. 
Human 
communication 
with a machine is another matter entirely. 


There are no implications 
or nuances of expression. 
The device is, to 
use Wiener's 
expression, 
totally 
literal-minded, 
and 
dealing 
with 
a literal-minded 
agency is a task for which we are not by nature 
equipped, 
and our folk lore is rich in stories which illustrate 
our 
awareness 
of it. There are many such stories but perhaps 
the most 
vivid of them is called "The 
Monkey's 
Paw" 
by W.W. Jacobs. 
In 
this story an elderly English couple comes into possession of a magic 
piece, brought 
back from India by a member 
of the British Army 
stationed 
there. The magic piece, a monkey's 
paw, allows them three 
wishes, the first of which is for a large sum of money. This wish is 
granted when their son is mangled to death in machinery 
and the in- 
surance company 
pays off his life policy. The second wish is for the 
return of their son to life. This is granted when they are tortured 
by 
the sound of his mangled body hammering 
at their door in the mid- 
dle of the night. The third wish is used to return the son to his grave. 
The point of this and all such stories is that the magic agent is 
completely literal-minded, 
as is an automatic 
device like a computer. 
This was the characteristic 
of computers 
that bothered Wiener in the 


quote at the head of this chapter. 
Does victory mean that one more 
of us is left alive than of them? The logical outcome 
of this defini- 
tion of victory is a single human 
left alive. Is this what we really 
mean by victory? I think not, and become very uneasy at the idea of 
offensive 
and defensive weapons 
systems under the control 
of pro- 
gramming 
about which I know nothing. 
As Wiener says, the only difference 
is that we now possess effec- 
tive devices of this kind. We must learn to deal with them, learning 
to instruct them in a totally literal way, and in this completely literal 
character 
of the instruction 
lies the psychological 
alienness 
of the 
task. 
If this is only well understood 
the reasons 
for the failures 
to 
solve the problem 
of programming 
difficulty 
become immediately 
obvious. While one computer 
language form may differ from anoth- 
er in its superficial 
aspects (compiler, 
assembler, 
etc.) all of these 
language forms without 
exception require that we conceptualize 
the 
problem 
in totally literal, discrete steps. If the problem 
to be solved 
can be conceived 
of in this way then the difficulty 
vanishes. 
After 
this has been done the language in which the problem is programmed 
is pretty much irrelevant. 
Different 
languages offer facilities for con- 
venient expression of problem solutions of different 
classes. Some of 
these languages succeed and others fail. The most long lived and suc- 
cessful of the higher level languages, 
FORTRAN, 
succeeded not be- 
cause it relieved the programmer 
of the job of correctly conceptual- 
izing the problem 
to be solved, but because it addressed 
a class of 
problems 
(mathematical) 
which 
had 
been 
reduced 
to procedural 
form 
long before 
the invention 
of the first computer. 
Relatively 
speaking, 
they were the easy problems. 
FORTRAN 
did not perform 
well for the problems 
of business, and other language forms were in- 
vented 
for these applications, 
eventually 
converging 
into COBOL 
and RPG. COBOL and RPG succeeded because they addressed 
a set 
of problems 
which were already well defined and reduced to proced- 
ural form. All of this is by way of saying that a programming 
lan- 
guage is an effect, not a cause. It exists as a response to the develop- 
ment of the ability to define a class of problems in precise procedural 
terms. It is the confusion 
of cause and effect which has led to the ap- 
pearance 
and disappearance 
of so many 
programming 
languages 
over the years. Most of them were cures for diseases which did not 
exist, or which existed in such minor form than the language which 
addressed 
them had negligible application. 
The central nub of the 


problem 
of programming 
and the nucleus of the difficulty 
of the ac- 
tivity is the need to define the problem to be solved in discrete, total- 
ly literal steps, and any system of programming 
which purports 
to 
relieve the programmer 
of this responsibility 
misrepresents 
itself. 


This is most eloquently put by Norbert Wiener: 


"No, the future offers very little hope for those who expect that our 
new mechanical slaves will offer us a world in which we may rest from 
thinking. Help us they may, but at the cost of supreme demands upon 
our honesty and our intelligence. The world of the future will be an ever 
more demanding struggle against the limitations of our intelligence, not 
a comfortable hammock in which we can lie down to be waited upon by 
our robot slaves!' 


Norbert Wiener 
God & Golem, Inc. 
1964 


The problem 
thus reduces to finding some way to match a human 
mind which operates in a fuzzy, associative way, with a robot which 
will tolerate 
no fuzziness and is incapable 
of association. 
A funda- 
mental adaptation 
must be made by one or the other. Since the com- 
puter cannot adapt because we do not yet know how to build a ma- 
chine capable of adaptation, 
it is the human mind which must stretch 
to bridge the gap. That this is possible is testified to by the many suc- 
cessful existing applications 
of computers, 
but it is not easy, and the 
road to any successful computer 
application 
is littered with potholes 
into which the unwary 
will fall. Computer 
programming, 
like any 
other significant 
skill, is built heavily on experience. 
Good program- 
mers are made, 
like good brain surgeons 
and engineers, 
by experi- 
ence, Le., by making 
mistakes, 
finding 
the reason 
for the failure, 
fixing it and remembering the mistake so it isn't repeated. 
It is tempting, 
when dealing with a particularly 
exasperating 
mis- 
take, 
to claim machine 
failure. 
This may save the ego for the mo- 
ment, but it is almost never true. In the writer's experience, which in- 
cludes some of the early vintage vacuum 
tube machines, 
only once 
has an error 
turned 
out to be traceable 
to machine 
malfunction. 
While this may be partly due to good fortune, 
it remains true that er- 
rors caused by the programmer 
far outnumber 
those which might be 
caused by the machine. 
Having so described the dimensions 
of the programming 
problem, 
there remains the question of getting the necessary "hands 
on" expe- 


rience to acquire 
the skill. The reader 
is urged at this point to follow 
the directions 
in appendix 
A for initializing 
the assembler 
and de- 
bugging 
monitor. 
Using 
these 
two programs, 
the various 
example 
programs 
in the text can be tried out as they are studied. 
Only in this 
way can a real understanding 
of their functions 
be achieved. 
The op- 
erating 
instructions 
for the assembly 
program 
are in chapter 
4, and 
those for the debugging 
monitor 
in chapter 
17. Those already 
famil- 
iar with operations 
on binary quantities 
and the general 
organization 
of a computer 
can skip directly 
to chapter 
4 and begin. 
If you are 
fuzzy on these topics by all means do not skip these chapters. 
Under- 
standing 
their contents 
is vital to successful 
programming 
of the 280 
or any other computer. 


2 I 
BINARY 
OPERATIONS 


"We have seen that the symbols of logic are subject to the special law 
x' =x. Now of the symbols of Number there are but two, viz, 0 and 1, 
which are subject to the same formal law. We know that 02=0 and that 
F = 1; and the equation x' = x, considered as algebraic has no other 
roots than 0 and 1. Hence, instead of determining the measure of for- 
mal agreement of the symbols of Logic with those of Number general- 
ly, it is more immediately suggested to us to compare them with sym- 
bols of quantity admitting only of the values of 0 and 1. Let us con- 
ceive, then, of an Algebra in which the symbols x, y, z, etc. admit indif- 
ferently of the values of 0 and 1, and of these values alone. The laws, 
the axioms, and the processes of such Algebra will be identical in their 
whole extent with the laws, and axioms and the processes of an Algebra 
of Logic. Difference of interpretation will alone divide them. Upon this 
principle the method of the following work is established?' 


George Boole 
An Investigation of the Laws of Thought 
1854 


The fact that computers are built of components which can exist in 
only two electronic states makes itself felt in almost all transactions 
between programmer and computer. It is the purpose of this chapter 
to give the beginning programmer an understanding 
of the workings 
of a two state system of arithmetic and other operations which take 
place within the computer. The two states may be given any desired 
set of names, on an off, yin and yang or Romeo and Juliet, but they 
are conventionally referred to as one and zero. Sometimes the zero 
state is called reset and the one state set. 


A system for the expression of information 
which uses only two 


states may seem strange at first, but if the reader reflects on the mat- 
ter he will realize that he has encountered such systems before. Traf- 
fic is controlled by a system of lights that have two states, green and 
red. The intermediate yellow is not a state at all, merely a warning 
that a change of state is about to take place. Morse code is a system 
of communication 
in which information 
is transmitted by means of 


combinations of two states, dots and dashes. An earthier form of 
two state communication is implied in the statement: "If the shade is 
up don't come in. My husband is home". Paul Revere's "one if by 
land and two if by sea" is another example. We deal with two state 
codes all the time almost without realizing that we are doing so. 
What is unfamiliar is the idea of expressing numerical information 
in a two state code. 
This is the natural consequence of being born with ten fingers. 
There is a certain subjective "rightness" about counting by tens and 
computing in base ten. This feeling of "rightness" 
has no objective 
base, of course, as a look into history quickly shows. In ancient 
times twenty was commonly used as a number base in parts of the 
world in which the climate allowed people to go barefoot or wear 
open sandals. Some Europeans of the middle ages and later used 
twelve as a number base, the traces of this number base still showing 
in modern language in such terms as dozen and gross. 
This feeling of familiarity is quite superficial, and this can be easi- 
ly shown with young children who have not had enough time to ac- 
cumulate the necessary prejudice. As we will see in a few pages, it is 
possible to count up to 31 using only five digits in base two. The five 
digits can be represented by the fingers of one hand. The letters A 
through Z can thus be set into one to one correspondence with base 
two numbers, A being one, etc. Even very young children, as young 
as seven, catch on to this system of communication very quickly. All 
that is required is to know how to spell the necessary words and 
count. The message is spelled out as a series of base two hand sig- 
nals, an upraised finger being a one and a lowered finger being a 
zero. A seven year old can be conversing quite fluently in this system 
in only 15minutes or so, though the representation of the letter "D" 
has caused some problems by its unfortunate coincidence with an- 
other type of hand signal. 


As with decimal and all other number systems the position of a 
digit in a binary number has place value, the values of successively 
higher digit positions being the successive powers of the number 
base. The decimal number 2937,for example, really means: 


the value of 10° being one. Similarly 
the base two or binary number 
10101 has the meaning: 


the value of 2° again being one. If the reader 
is unfamiliar 
with this 
zero power 
business 
it is fairly easy to show from the laws of expo- 
nents. The result of the division: 


But since the divisor and dividend 
are equal the result of the division 
must be one, since dividing 
anything 
by itself results in a quotient 
of 
one. Any number 
to the zero power is therefore 
one. 
The decimal 
value of the base two number 
shown above is easy to 
compute 
when written 
in this expanded 
form. 
The terms containing 
zeros are ignored, 
just as in decimal, 
and the values of the remaining 
terms are added, 
namely the 24, 22 and 2° terms. 
Since the only possi- 
ble multiplier 
for these terms is one, not 1 through 
9 as in decimal, 
this amounts 
to simply adding: 


As a convenient 
reference, 
the first few powers 
of two are shown 
in tabular 
form below. 


2° =1 
21 =2 
22 =4 
23 =8 
24 = 16 
2s = 32 


26 =64 
27 = 128 
28 =256 
29 = 512 
21°= 1024 
211 = 2048 
2 
12=4096 
2 
13=8192 
214 = 16384 
215 = 32768 
216 = 65536 


Using the above table convert the binary number 
11001001 
to decimal. 
The number 
is first written 
in the expanded 
form shown above, Le.: 


Dropping 
the terms which contain 
zero multipliers 
and 
substituting 
the values 
of the powers 
of two from 
the 
above table, we have: 


This process of conversion 
will be tedious at first but with a little 
practice it will become familiar. 
Before leaving example 2-1 take note of the fact that the binary 
number 
11001001 required 
eight digit positions, 
while its decimal 


value, 
128, required 
only three. 
Binary numbers 
are long, tedious 
things and working with them in this form is a quick way to intro- 
duce errors. 
For this reason 
programmers 
use shorthand 
methods 


for writing binary. 
These are called the octal (base 8) and hexadeci- 


mal (base 16) systems. Computation 
is almost never done in these 
systems but it is necessary to know how they are represented. 
Conversion 
between binary and octal is simply a matter of group- 
ing the binary digits (bits) and then reading off the decimal equiva- 
lents of each group. The binary number in example 2-1, for example, 
is converted to octal by splitting it into groups of three bits, begin- 
ning at the right, like this: 


The decimal equivalent of each group is then read off. The leftmost 
group is a 3, and the other two groups are both l' s. The result is then 
written: 


the subscripts 
indicating 
the number bases. A longer conversion 
of 
this type is shown in example 2-2. 


Convert 
the binary 
number 
0001100110011001 to octal. 


The number is divided into groups of three bits, beginning 
at the right, the decimal equivalent of each group written 
underneath, 
like this: 


o 
001 
o 
1 
100 
110 
011 
001 
463 
1 


Note here that since the number of bits in the binary num- 
ber was sixteen, not a multiple of three, the leftmost group 
has only one bit. 


The conversion 
from octal to binary 
is equally simple. Each of the 
octal 
digits is simply 
expanded 
to three 
bits, 
as shown 
in example 
2-3. 


Convert 
the octal number 
72613 to binary. 
This is done by 
spreading 
out the octal digits and writing 
the binary 
equi- 
valent of each underneath. 


72613 
111 
010 
110 
001 
all 


The note at the end of example 
2-2 about 
the dangling 
lefthand 
bit 
brings up a point about 
the octal number 
system which must be con- 


sidered 
before 
using it as a shorthand 
for binary 
in programming. 


Computers 
in general 
group 
bits into units whose size is an integral 
power of two, Le., 4, 8, 16, or 32 bits. Since none of these groupings 
is an even multiple 
of three there will always be a leftmost 
bit group 
containing 
less than three bits if octal is used. 
It is this fault 
of the 
octal system which leads to consideration 
of an alternate 
shorthand 
for binary, 
the hexadecimal 
system. 


Conversion 
of binary 
to hexadecimal 
is accomplished 
by grouping 
the bits into fours, 
then reading 
off the value of each, as with octal. 


The only problem 
is that four bits can represent 
a number 
whose val- 
ue is greater 
than nine. Since we have no single symbols 
to represent 
these numbers 
in the decimal 
system, 
we simply 
invent 
symbols 
- 
the first six letters 
of the alphabet. 
The symbols 
used for hexadeci- 
mal conversion 
are shown in table form below. 


Binary 
0000 
0001 
0010 
0011 


Hexadecimal 
a 
1 
2 
3 


0100 
0101 
0110 
0111 
1000 
1001 
1010 
1011 
1100 
1101 
1110 
1111 


Conversion between binary and hexadecimal can be done by refer- 
encing the above table. The binary number of example 2-1, 11001001, 
is converted by dividing it into two groups of four bits each, as: 


The rightmost 
group is simply a nine, an eight bit plus a one bit. The 
left group is a twelve, however an eight bit and a four bit. Looking in 
the table above, we see that the symbol for twelve is C. The result is 
then: 


While the alphabetic 
symbols may give you trouble 
for a while the 
system becomes familiar with a little practice and it offers important 
advantages 
over octal when dealing with computers 
like the Z80, as 
we will see. A more elaborate 
conversion is shown in example 2-4. 


Convert the binary number 0111111010110100 to hexadeci- 
mal. The number 
is written 
in four four bit groups, 
like 
this: 


The leftmost 
group can be read immediately 
as a 7. The 
second group from the left has value 14 for which the sym- 
bol in the table is E. The third group has value 11, symbol 
B. The rightmost group can be read directly as a 4. 


The simplest possible operation 
performed 
by a computer, 
at root 
the only operation 
of which it is really capable, is the comparison 
of 
one bit to another, 
setting another 
bit or bits to reflect the result of 
this comparison. 
All of the more complex operations 
are built up out 
of these simple bit comparisons. 
One type of bit comparison 
opera- 
tion is known as the Inclusive OR. In this operation 
two bits are 
compared and the result set to a one if either or both of the bits being 
compared 
is a one. Like the operations 
of arithmetic, 
the Inclusive 
OR operation 
has a sign, V. To indicate 
the Inclusive OR of two 
quantities 
they are written with the "V" 
between them. All of the 
possible cases are: 


IV1=1 
IVO=1 
OV1=1 
OVO=O 


The result of an Inclusive OR can be zero if and only if both of the 
bits being ORed are zero. In the Z80 and other computers 
bits are 
ORed in groups rather than singly. In the Z80 eight bits can be han- 
dled in parallel at one time. This operation is shown in example 2-5. 


Form the Inclusive OR of the eight bit binary quantities 
10110101and 11000100. 


10110101 
V 11000100 


The work may go from left to right or right to left but we 
will go from right to left to preserve consistency with the 
direction used in addition and subtraction 
operations 
to 
come later. To avoid excess verbiage in describing the bit 
positions within the eight bit group we will number the bits 
o through 7, 0 meaning the rightmost and 7 the leftmost 
bit. The operation is begun by ORing the 0 positions. The 
top bit is a one and the bottom a zero. The result is there- 
fore one, written below, like this: 


10110101 
V 11000100 


1 


Next the bits in the 1 position (second from right) are 
ORed. They are both zero so the result is a zero, again 
written below, as: 


10110101 
V 11000100 


01 


This right to left sweep is continued until all eight posi- 
tions have been ORed and the results written below. The 
final result looks like this: 


10110101 
V 11000100 


11110101 


The numbering of the bits from right to left in example 2-5 was 
not randomly chosen. Notice that the number of the bit position cor- 


responds 
to the power of two represented 
by that position. 
The oper- 
ation 
performed 
in example 
2-5 is also known 
as the logical sum. 
When the single word OR is used from this point 
on in this book it 
is the Inclusive 
OR function 
which is meant. 
This is to distinguish 
it 
from 
another 
type of OR operation 
which we will consider 
in a lit- 
tle while. 
Another 
type of bit comparison 
operation 
is known 
as the AND, 
also sometimes 
called the logical product. 
In the AND 
operation 
a 
pair of bits is compared 
and the result set to one if and only if both 
of the bits being compared 
are ones. 
If either 
or both 
bits are zero 
the result is a zero. It is fairly easy to see why this is called the logical 
product. 
The result is the same as if the two bits were multiplied. 
The 
AND 
operator 
is an inverted 
"V". 
All possible 
cases for AND 
are 
shown below. 


lAl=1 
lAO=O 
OA1=0 
OAO=O 


As with the OR function, 
the AND 
is performed 
on the Z80 eight 
bits at a time. The operation 
is shown in example 2-6. 


Form 
the AND 
of the two binary 
quantities 
in example 
2-5. 


10110101 
A 11000100 


10000100 


Note that ones appear 
in the result 
if and only if both 
of 
the bits above 
were ones. If either is a zero the result 
is a 
zero. 
The AND 
operation 
is usually 
used in an operation 


called masking. The purpose of masking is to isolate some 
group of bits within a larger group by setting the irrelevant 
information 
to zeros. This is done by forming 
a mask to 
be ANDed 
with the information, 
this mask 
containing 
ones only in the bit positions 
to be preserved 
and zeros 
elsewhere. 
To isolate the lower four bits of the 10110101 
above a mask is constructed 
with ones in the low bits and 
zeros in the remaining bits. The operation 
looks like this: 


10110101 
A 00001111 


00000101 


Do not leave this example without understanding 
it. This 
operation 
will appear many times in this book. The AND 
operation 
is also sometimes called the logical product. 


Yet another type of comparison 
operation 
is the Exclusive OR, al- 
so called the logical difference. In this operation 
the result is a one if 
and only if the bits being compared 
are different. 
The symbol for 
Exclusive OR is a crossed V, Le., V. All possible cases of Exclusive 
OR are shown below. 


IV1=0 
IVO=1 
OV1=1 
OVO=O 


Again, the result is a one only if the bits being Exclusive ORed are 
different. 
Notice here that the Exclusive OR function is the same op- 
eration 
performed 
on algebraic signs of numbers 
when multiplying 
or dividing. If a one represented 
minus and a zero plus, the result of 
Exclusive ORing will correctly predict the sign of a product 
or quo- 
tient, the algebraic rule being that the result will be minus only if the 
signs of the operands 
are different. 
The Exclusive OR of two eight 
bit quantities is shown in example 2-7. 


Form the Exclusive OR of the two eight bit binary quanti- 
ties in example 2-5. 


10110101 
V 11000100 


01110001 


The Exclusive OR operation 
is an efficient way to test two 
sets of bits for equality. 
If the two quantities 
are identical 
the result of an Exclusive OR will be all zeros. 


A logical operation 
which is performed 
on a single bit rather than 
a pair 
of bits is known 
as complementation. 
Complementation 
means the simple inversion of the value of the bit. If the bit is one its 
complement 
is zero. If the bit is zero its complement 
is one. Comple- 
mentation 
is usually indicated 
by a bar over the quantity 
to be com- 
plemented, 
Le.: 


As with the other logical operations, 
complementation 
is performed 
on eight bits at a time in the Z80. This operation 
is shown in example 
2-8. 


Form the complement 
of the eight bit number 
10101010. 
The complement 
is formed 
by simply inverting 
the value 
of each of the bits, ones becoming zeros and zeros becom- 
ing 
ones. 
The 
complement 
of 
10101010 is 
therefore 
01010101. Note that if this result is itself complemented 
the 


original 
number 
comes 
back, 
Le., 
the 
complement 
of 
01010101 is 10101010. 


The complementation 
process 
just 
described 
is also known 
as 
one's complementation 
to distinguish 
it from another 
type of com- 
plementation 
which we take up a bit later in this chapter. 


Another 
operation 
performed 
on a group of bits is known as shift- 
ing. To picture what goes on in a shift imagine a section of conveyor 
which is divided into eight discrete spaces separated 
by barriers. 
A 
space may contain a box (a one) or no box (a zero). The conveyor is 
capable 
of being moved only by integral 
spaces, Le., it cannot 
be 
moved half a space or one and a half spaces, only one space, two 
spaces, etc. Now move this imaginary 
conveyor one space to the left. 


If the leftmost 
space contained 
a box (a one), the box falls off the 
end, and a new empty space enters from the right. If the conveyor 
spaces were numbered 
0 through 
7 as in example 2-5, the content of 
space zero would move to space one, that of space one would move 
to space two, etc. 
If the conveyor had been shifted to the right just the opposite 
ef- 
fect would have taken place. The content of space zero would fall off 
the end and an empty space (a zero) would have been introduced 
on 
the left, with the new content of space seven moving to space six, etc. 
The left shift is shown in example 2-9. 


Perform 
a left shift of the eight bit number 00111111. The 
shift can be done on paper by simply writing a zero at the 
right hand end and omitting the leftmost bit, Le.: 


Before leaving this example, 
note one important 
effect of 
a left shift. The value of the original 
number, 
0011111b 


was 6310, 
The 
value 
of the 
shifted 
number, 
011111102 
= 12610, double the original value. This illustrates 
an im- 
portant 
effect. If no significant bits are shifted out by a 
left shift, the effect of the shift is to multiply the original 
number by 2. This property 
of a left shift will be used 
many times in the remainder of this book. 


Perform 
a right shift of the eight bit number 
00110001. 


This shift can be done easily by adding a zero to the left 
hand end of the group and omitting the rightmost 
bit, Le., 
00110001 becomes 
00011000, the bit shifted 
out having 
been a one. Now look at the values of the original number 
and 
the 
shifted 
number. 
001100012 = 4910 
while 
000110002 = 2410• The effect, in this case, is to divide the 
original number by two, ignoring any remainder. 
This will 
not be strictly true when we come to deal with negative 
numbers. 
The general statement 
of the effect of a right 
shift is this. Shifting right one bit has the effect of dividing 
by two and rounding in the direction of the next more neg- 
ative number. This effect will also be used many times in 
the remainder of this book. 


The operations 
so far discussed can now be combined to perform 


some simple arithmetic. 
The sum of two binary digits, called the ad- 
dend and the augend, can have only four outcomes. These are: 


0+0=0 
0+1=1 
1+0=1 
1+1=0 


with no carry 
with no carry 
with no carry 
with a carry into the next higher order bit 


Ignoring 
carries into higher order bits for a moment, 
these sums are 
exactly the same result which would be gotten by performing 
the Ex- 
clusive OR of the bits being added. 
It is for this reason 
that the Ex- 
clusive OR operation 
is also sometimes 
known 
as half add. In the 
single case in which a carry can be generated, 
both of the bits being 
added 
must be ones. This corresponds 
exactly to the result obtained 
with an AND operation. 
Thus the sum column 
can be generated 
by 
an Exclusive 
OR of the bits, while the carry into the next higher 
or- 
der column 
can be generated 
by an AND. 
In the higher 
order 
col- 
umns 
the carry 
out 
of lower 
orders 
must 
be accounted 
for. 
This 
changes 
things somewhat, 
since now there is the sum of three bits to 
be considered. 
The possible cases are these: 


carry in 
addend bit 
augend bit 
sum bit 
carry out 
0 
0 
0 
0 
0 
0 
0 
1 
1 
0 
0 
1 
0 
1 
0 
0 
1 
1 
0 
1 
1 
0 
0 
1 
0 
1 
0 
1 
0 
1 
1 
1 
0 
0 
1 
1 
1 
1 
1 
1 


This is the general 
case of addition 
of addend 
and augend 
bits in- 
cluding carry in from a lower order. 
In the case of the rightmost 
bit, 
of course, 
the carry in is always zero for a simple add. 
The above rules make it possible 
to perform 
eight bit addition 
us- 
ing Exclusive 
ORs to form 
the sum bits, ANDs 
to form 
the carries 
and shifts 
to move the carries 
into the next higher 
order 
columns. 
The carries 
are then again 
Exclusive 
ORed 
with the half sum pro- 
duced by the previous 
Exclusive 
OR. This is repeated 
until the carries 
are all zero. The process looks like this. 


00001001 
00000111 
the augend, 
a nine 
the addend, 
a seven 


Since the result of the AND is not zero, there is a carry. The carry or 
carries are shifted into the next column by performing 
a left shift, 
Le. the result of the AND becomes: 


The result of the Exclusive 
OR becomes 
the new addend 
and the 
shifted result of the AND becomes the new augend and the process is 
repeated. 


00001110 
¥ 00000010 


00001100 


00001110 
and 
A 00000010 


00000010 


Since the result of the AND is not zero, it is shifted left again and the 
process is repeated, Le.: 


00001100 
¥ 0000100 


00001000 


00001100 
Exc. OR result 
A 00000100 
AND result, shifted left. 


00000100 


The result of the AND is again nonzero, 
so we shift it left and try 
again. 


00001000 
¥ 00001000 


00000000 


00001000 
A 00001000 


00001000 


000ססoo0 
¥ 00010000 


00010000 


00000000 
A 00010000 


00000000 


The AND result is now a zero, so the final result of the process is the 
outcome 
of the last Exclusive OR. The value of this number, 
00010000, is 1610, the correct sum of the original numbers, 9 and 7. 
Subtraction 
can be done by a process implemented in a similar 
way. It is performed on a pair of bits called the minuend, the number 
from which something is being subtracted, 
and the subtrahend, 
the 
number which is being subtracted from the minuend. The four cases 
of simple subtraction are: 


0-0=0 
1-0= 1 
0-1 = 1 
1-1=0 


no borrow 
no borrow 
borrow from higher order 
no borraw 


The result bit, called the difference, is again a one if the minuend 
and subtrahend 
bits are different, 
just as in addition. 
This means 
that the Exclusive OR can again be used to form this partial result. 
The borrow bit becomes a one only if the minuend bit is zero and the 
subtrahend bit a one. If the borrow bit is represented by B, the minu- 
end bit by M, and the subtrahend bit by S, the condition for a bor- 
row is: 


As subtraction 
is usually done on paper, the borrow is effected by 
decreasing the next higher order minuend digit by one, Le., decre- 
menting it. The same effect can be gotten by incrementing the next 
higher subtrahend digit before proceeding to that column, and this is 
indeed what is done. The reader might find it an instructive exercise 
to go through a binary subtraction on paper using this method. 
Negative numbers are represented on the Z80 computer by means 
of their two's complements. 
The two's complement of a number is 
formed by first taking the one's complement as shown earlier in this 
chapter, and then adding one. The process is shown in example 2-11. 


Find 
the 
two's 
complement 
of 
the 
eight 
bit 
number 
00001011. First the one's 
complement 
is found 
by invert- 
ing every bit, Le.: 


11110100 
+ 
1 


11110101 


Since the decimal 
value of the original 
number 
was 1110, 
this result ought to represent 
-1110, This is easy enough 
to 
check. 
If we simply 
add the original 
number 
to its two's 
complement 
we ought to get zero. 


00001011 
+ 
11110101 


1 
00000000 


the detached 
one being the carry out of the high order bit 
sum. This carry is simply discarded. 
The result is correct. 


Before 
leaving 
example 
2-11, the reader 
should 
note 
something 
about 
the number 
used and its two's 
complement. 
The positive 
or 
negative 
character 
of a number 
in the two's 
complement 
system can 
be determined 
by looking 
at the leftmost 
bit of the number. 
If this 
bit is a zero the number 
is positive, 
if a one, negative, 
but the differ- 
ence runs 
deeper 
than 
this. 
In the positive 
number, 
00001011, 
the 
highest 
significant 
digit was in the 23 position, 
Le., the eight's 
bit. 


All the bit positions 
above this were filled with nonsignificant 
zeros. 
In the negative 
number, 
however, 
a significant 
bit is a zero, 
not a 
one. The highest 
significant 
bit in the negative 
number 
is the zero in 


the eight's position. 
The positions 
above this are filled with nonsig- 
nificant 
ones. In both cases the leading nonsignificant 
bits are filled 
with copies of the sign bit, zero for positive and one for negative. 
While we will speak in this book of the leftmost bit being a sign indi- 
cator, it must be understood 
that the sign fills aI/leading nonsignifi- 
cant bits, whether positive or negative. 
In dealing with any computer, 
but particularly 
with machines like 
the Z80 which handle data eight bits at a time, the generation 
of a re- 
sult too large to be held in the allotted 
space must be considered. 
This condition 
is known as overflow. It is distinct from and does not 
have the same meaning 
as a carry out of the high bit. Overflow 
oc- 
curs when two signed numbers 
are added or subtracted 
to give a re- 
sult which cannot be held in the allotted space. It is most important 
to understand 
this, so do not skip over the remainder 
of this chapter. 
You do so at your peril. 


The largest number which can be held in N bits is 2N-1. For eight 
bits this means 255, or 28-1. If the eight bit group has an algebraic 
sign one bit must be allotted to it, leaving only seven to contain the 
magnitude 
of the number. 
The largest magnitude 
expressible in sev- 
en bits is 27-1 or 127, or in binary: 


01111111 
+ 
1 


10000000 


which, if considered 
only as a magnitude, 
is correct, 
128. But since 
the leftmost 
bit contained 
an algebraic 
sign, this is not correct as a 
signed result. We have added two positive numbers and gotten a neg- 
ative sum. This is the overflow condition. 
Overflow 
can only occur 
when numbers of like sign are added or when numbers of unlike sign 
are subtracted. 
Now let us consider 
the negative 
case, if we negate (Le., two's 
complement) 
the + 127 above we get: 


this being the correct 
two's 
complement 
representation 
of -127. We 
will subtract 
one from this by adding 
a minus one. The two's 
com- 
plement 
representation 
of minus one is 11111111. The reader 
should 
verify this by going through 
the two's complement 
process with pen- 
cil and paper. 
The addition 
of -127 and -1 is represented 
by: 


10000001 
+ 
11111111 


10000000 


but this result 
is valid. 
We have added 
two negative 
numbers 
and 
gotten 
a negative 
result. 
This illustrates 
something 
important 
about 
the two's 
complement 
system. 
There 
is one more 
negative 
number 
than 
positive. 
The 
maximum 
negative 
number 
in 
eight 
bits 
is 


10000000. If a minus one is added to this an overflow 
will result, i.e.: 


10000000 
+ 
11111111 


01111111 


Here two negative 
numbers 
have been added 
to produce 
a positive 
result, 
and overflow. 
The Z80 computer, 
unlike 
its predecessor 
the 
8080, has hardware 
means for detecting 
the overflow 
condition. 
The 
exact means 
for using this hardware 
feature 
will be explained 
in a 
later chapter. 
The means by which it is detected 
are of some interest, 
however. 


Overflow 
is detected 
by monitoring 
the carry into the highest 
bit, 


i.e., the sign bit, and out of the highest 
bit. If these two carries 
are 
different, 
then an overflow 
has occurred. 
The Z80 has an overflow 
flag or overflow 
bit which is set to one when this happens. 
After 
an 
arithmetic 
operation 
the condition 
of the overflow 
bit is: 


Recall that the result of an Exclusive 
OR is a one if and only if the 
bits are different, 
and the meaning 
of this will be clear. The two con- 
ditions: 


1) An add or subtract has produced a result too large to be held in 
the signed space allotted; and, 


2) The carry into the sign and the carry out of the sign which re- 
sulted from the add or subtract were different, 


are equivalent. 


The subject of the maximum negative number touched on above 
requires a little expansion before we move on. This number cannot 
be negated (two's complemented) 
since it has no positive counter- 
part. It is instructive to see what happens if we try to negate it. 


10000000 
01111111 
+ 
1 


10000000 


-12810 
the one's complement of -12810 
plus one for two's complement 


the same number back! 


The result is the maximum negative number, but there is something 
else. During the addition of the one to the one's complement a one 
was carried into the sign but a zero was carried out. This is the over- 
flow condition we have just discussed. The 280 hardware will detect 
this and set the overflow bit. 


3 I 
THE lOGICAL. 
ORGANIZATION 
OF THE 
zao COMPUTER 


"Once the characteristic numbers for most concepts have been set up, 
the human race will have a new kind of instrument which will increase 
the power of the mind much more than optical lenses strengthen the 
eyes and which will be as far superior to microscopes or telescopes as 
reason is superior to sight:' 


Gottfried Wilhelm Liebnitz 
1679 


The purpose of this chapter is to present a conceptual 
picture of a 
computer 
which will allow a programmer 
to work with it in an effi- 
cient way. That the organizational 
ideas presented 
here do not cor- 
respond to the hardware 
organization 
precisely will be obvious. The 
concepts to be understood 
in this chapter must be viewed in the same 
way as that in which a navigator, 
for purely computational 
pur- 
poses, views the stars as being projected 
onto a sphere of infinite ra- 
dius. The model does not correspond 
to the physical truth but pro- 
vides great operational 
convenience. 
The computer model presented 
here should be viewed in the same way - 
a useful artifice. 
It is productive 
for a programmer 
to view the computer 
as being 
composed 
of three distinct logical components; 
a memory, 
an arith- 
metic/logic 
unit, and a controller 
or central processing unit (CPU). 
Memory consists of a device into which information 
may be placed 
and from which it can be repeatedly retrieved without destruction, 
in 
much the same way that words may be written on paper and read 
back repeatedly without vanishing from the paper. Writing informa- 
tion into computer 
memory erases or clears the previous 
contents. 
The act of writing information 
into memory is called storing. The 
meaning of this word is quite specific and unique. 
Memory is organized into groups of digits of equal length, each of 
these groups being known as a word. The number 
of digits or bits 


which constitutes 
a word is known as the word length. For the Z80 
the word length is eight bits. By coincidence, 
eight bits is also called 
a byte, but we will adhere to the more general nomenclature 
in this 
book. Each word of memory has associated with it a unique number 
which identifies it and it alone. This number is known as the address 
of the word. Addresses usually begin with zero and run to the highest 
number memory word available, 
without gaps, but this need not be 
so. The address of a word functions 
like the number of a post office 
box. The post office box number has nothing to do with the contents 
of the box and the address of a memory word has nothing to do with 
the contents of that word. It is quite important 
to understand 
the dif- 
ference between the address of a memory word and its contents. 
The word size is determined 
by the hardware 
designer. 
The pro- 
grammer 
can exercise no control 
over it. This does not means that 
the Z80 is limited to processing 
information 
of length eight bits or 
less. The operations 
of the computer 
allow words to be "chained" 
end to end, so that arithmetic 
may be performed 
on data of any re- 
quired length. 
The arithmetic/logical 
unit resembles 
a pocket 
calculator 
in its 
function, 
except, of course, that its calculation 
is done in binary. 
It 
contains one or more registers, temporary 
storage devices capable of 
holding 
one or more computer 
words. 
In the Z80 the main opera- 
tional register is the A register. It is in the A register or accumulator, 
that most of the arithmetic 
and logical work of the computer is done, 
though some arithmetic 
can be performed 
in other Z80 registers. Ac- 
companying 
the arithmetic/logical 
registers is a group of bits known 
as the flag word. The individual 
bits of the flag word are set by the 
Z80 to reflect the outcome of operations 
performed 
in the arithmet- 
ic/logical 
registers, 
e.g., was the result a zero or did an addition 
or 
subtraction 
cause an arithmetic 
overflow. These flag bits can be indi- 
vidually tested, but more of this a little later. 


The computer 
components 
discussed so far have no unique pro- 
perties. 
The function 
of memory 
is the same as that of paper and 
pencil, while that of the arithmetic/logical 
unit (ALU) is the same as 
that of a pocket calculator. 
What is required to make the paper and 
calculator 
work is an intervening 
"intelligence" 
which can execute 
the steps necessary to get a useful result. This set of steps is known as 
the program. The implementation 
of the individual 
steps is the func- 
tion of the controller 
or CPU. It is the CPU which exercises the su- 


pervisory function, driving the other components in such a way as to 
perform the required task. 
The program 
steps, called instructions, 
reside in memory along 
with the numbers upon which these instructions are to operate. The 
CPU fetches the instructions from memory one at a time and super- 
vises their execution. To perform this task it contains two principal 
registers, the program counter or P register and the instruction or I 
register. The program counter contains the memory address of the 
instruction which follows the one currently being executed. How this 
comes to be is not important just now, but the fact should be noted 
and memorized. 
The program counter always contains the address 
of the instruction following 
the one currently being executed. In this 
function the program counter can be said to "point to" the next in- 
struction. This notion of a pointer is fundamental 
to the use of the 
Z80 or any other computer. Using the program counter as a pointer 
to the next instruction to be fetched and executed, the basic instruc- 
tion execution cycle of the computer consists of the following steps: 


1) 
The instruction 
pointed to by the program counter is fetched 
from memory and placed into the I or instruction register. 


2) 
The program counter is incremented by the amount necessary 
to point to the instruction which follows the one just fetched. 


3) 
The instruction 
in the I register is then interpreted 
as a com- 
mand to do something, e.g., move data between memory and 
ALU registers, test the status of some device external to the 
computer, perform an addition or subtraction, etc. 


4) 
The action implied by the interpretation 
in step 3 is then taken, 
Le., the data are moved, the device status tested, the addition or 
subtraction done, etc. 


In step 2 above the incrementation of the program counter was de- 
liberately left nonspecific. In the Z80, instructions may be one, two, 
three or four words long. The program counter is automatically 
in- 


cremented by the amount appropriate to the instruction. 


aving discussed these general considerations, 
we now turn to the 
specifics of the Z80 computer. Like most microcomputers, 
the Z80 is 
organized around a set of registers which are usually thought of as 
pairs of eight bit registers or single sixteen bit registers. These regis- 
ters are: 


AF - 
This pair consists of the accumulator 
previously discussed 
and a flag word whose bits are set to reflect the outcome of 
the last operation performed. 
Only 6 of the 8 bits of the F 
register are used. The bits are: 


A - 
a one if a carry/borrow 
occurred between bits 3 and 4 
of the A register during the last operation; 


v - 
a one if the last operation 
resulted 
in arithmetic 
overflow; 


N - 
a 
special 
flag 
used 
during 
decimal 
arithmetic 
operations; 


C - 
a one if a carry or borrow was propagated 
out of the 
high bit of A during the last operation. 


BC - 
The Band 
C registers may be individually manipulated 
or 
used together as a pointer to transfer data between the A reg- 
ister and memory. 


HL - 
The Hand 
L registers perform the same functions as BC and 
DE above. In addition, data may be moved to or from mem- 
ory and the A, B, C, D or E registers using HL as a sixteen 
bit pointer. 


AF' ~ 
BC' 
DE' 
HL' 


These four register pairs form a second set which perform 
the same functions as their nonprimed counterparts 
above. 
Only one set of registers may be worked on at a time, but 
switching from one set to the other is a very simple matter. 
This extra register sets represents a major extension of capa- 
bility over the Z80's predecessor. 


An abbreviation 
for Stack Pointer. 
The 16 bit SP register 
allows a special type of data movement between other regis- 
ters and memory and between the program 
counter 
and 
memory. 


The X register is used as a single 16 bit register to transmit 
information between memory and other registers. The point- 
er contained 
in X may be modified by the addition 
of a 
signed displacement. 
This makes X a powerful instrument 
for addressing arrays of data in memory. 


Same function 
as described for X above. The X and Y 
registers represent a significant increment of power over the 
8080. 


The main arithmetic register of the Z80 is A, in which arithmet- 
ic/logical operations may be performed on data eight bits at a time. 
Some sixteen bit arithmetic can also be done using the BC, DE and 
HL pairs. The ways in which these registers and register pairs are 
used to perform common programming tasks is the subject of the re- 
mainder of this book. 


MACHINE AND 
ASSEMBLY LANGUAGE 
PROGRAMMING 


4 / 


"When I use a word", Humpty Dumpty said in a rather scornful tone, 
"it means just what I choose it to mean - 
neither more nor less:' 


Lewis Carroll 
Through the Looking Glass 


In chapter 
3 the concept 
of an instruction 
was discussed. 
The in- 
structions 
of a program, 
being held in the same memory 
as the data 
upon which they operate, 
are simply binary 
numbers. 
It follows then 
that it is possible 
to write a program 
to perform 
some useful 
func- 
tion entirely 
in binary, 
and this is indeed 
the case. Consider 
the bi- 
nary program 
below: 


hexadecimal 
memory address 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
lOA 
lOB 
lOC 
lOD 
10E 


binary contents 
00101010 
00010110 
00000001 
00010001 
00000001 
00000000 
10110111 
11101101 
01010010 
00111000 
00000100 
00010011 
00010011 
00011000 
11111000 


IOF 
11001011 
110 
00111010 
111 
11001011 
112 
00011011 
113 
11000011 
114 
00010011 
115 
00000001 
116 
---- 
117 
---- 


If this eighteen word program 
is manually entered into memory, the 
program counter set to 100 hex and the machine started, the program 
will take the square root of the sixteen bit number left in memory lo- 
cations 116 and 117.The problem with this kind of a program 
is that 
it has no meaning to a human programmer. 
The instruction 
at loca- 
tions 100, 101 and 102, for example, load the Z80's HL register pair 
with the contents of memory locations 
116 and 117.There is nothing 
about 00101010 0001011000000001 which suggests this function. 
The 
instruction 
at lOB adds one to the contents 
of the DE register pair, 
but there is certainly 
nothing 
about 
00010011 which suggests this 
function. 
There must be a better way. 
We could write a small program which would take typed hexadeci- 
mal digits from a keyboard and load them into memory. This would 
certainly 
be shorter 
than 
keying in directly in binary, 
but hardly 
more meaningful. 
Nothing 
about 2A1601 suggests loading the HL 
register pair. This is sometimes done during the program 
debugging 
process when a single instruction 
has to be "patched" 
into a pro- 
gram. It is not an efficient way to write a program of any size. 
This difficulty was understood 
very early in the craft of program- 
ming, of course, and means were invented to solve the problem. 
Pro- 
grams were created which were capable of translating 
specific sym- 
bols into binary patterns 
much as was suggested in the paragraph 
above. 
These simple programs 
rapidly 
evolved into sophisticated 
programming 
tools capable of translating 
a program 
written part- 
ly or totally in symbols into a machine 
language 
program. 
A pro- 
gram capable 
of doing this is known as an assembler or assembly 
program. 
In using an assembly program, 
the programmer 
prepares his pro- 
gram using symbols 
to represent 
the machine 
instructions. 
These 


symbols, 
called mnemonics 
(pronounced 
nee-mon-ics, 
initial m si- 
lent), from a Greek word meaning 
memory, 
are designed 
so as to 
suggest their functions. 
The A register is loaded by means of LDA 
and stored by means of STA, for example. The direct load of the HL 
register pair discussed above is represented 
by LHLD. 
The symbolic 
program 
is then transcribed 
onto some machine 
readable 
medium. 
This symbolic program, 
known as the source program, 
is then pro- 
cessed by the assembler. 
This processing, 
called assembly, has two 
results, an assembly listing and an object program. The object pro- 
gram will be taken up a bit later. An assembly listing of the square 
root program is shown in example 4-1. 


001 
002 
003 0100 
2A1601 


004 0103 
110100 
005 0106 
B7 


006 0107 
ED52 
007 0109 
3804 


008 310B 
13 


009 010C 
13 
010 
0100 
18F8 
011 010F 
CB3A 
012 0111 
CBIB 
013 0113 
C31301 


014 0116 
FFFF 
015 0118 


> SQUARE 
ROOT 
PROGRAM 
ORG 
:100 
LHLD 
N 
LXI 
0,,1 


RSC 
DSC 
Be 
INX 
INX 
BRA 
LRD 


HER 
JMP 
HF:RF: 
DBL 
6553<; 
END 


o 
END 
o 
o 
LOOP 


START 
H~RF..•BRUNHILDF. 
GET NUMBER 
1ST ODD 
INTEGER 
TO D-E 
CLEAR 
CARRY 
SUBTRACT 
ODD 
INTEGER 
CH05S 
ZERO? 


NO. 
FORM 
NEXT 
ODD 


INTEGER 
AND 
DO 
IT AGAI:-J 
DOUBLE 
SHIFT 
THE 
RESULT. 
ROOT 
IN E REG. 


s 
SEND 
S 


.*.**** ••• ********* •••*.*** 
>SYMBOL 
TABLE> 


••• *•• * •• **** •••••••••••• 
** 


The assembly listing in example 4-1 looks complicated 
but we will 
take it in easy steps. Notice first that the material in the listing is di- 
vided into distinct columns. 
The three digit number in the left hand 
column is simply the line number. 
It has nothing to do with the as- 
sembly 
process. 
it is there 
purely 
for editing 
purposes. 
Begin by 
looking at the column which has ORG in line 2. This is the column 
which contains 
the mnemonics 
for the machine 
instructions. 
It is 
known as the instructionjield. 
Just beneath the ORG is LHLD. This 
is the mnemonic 
for the machine instruction 
which loads the HL reg- 


ister pair discussed before. Loading, 
of course, implies loading from 
somewhere 
and this somewhere 
is given in the next column to the 
right. The N in this column is known as the operand of the LHLD 
and the column itself is called the operand field. The assembler must 
have some means of knowing what the programmer 
means by the N, 
since N is not a numerical 
address. 
On line 14 the column to the left 
of the instruction 
field contains 
the N we are looking 
for. When a 
symbol like N is used in this field, called the label field, it is said to 
be defined. The symbols LOOP, END and HERE 
are similarly 
de- 
fined by their use in the label field. 
Not all mnemonics 
require that their operands 
be defined in this 
way. The LXI on line 4 has D,1 as its operand. 
The LXI is another 
type of load, but one in which the data to be loaded are contained 
in 
the instruction 
itself. The D means the DE register pair. This instruc- 
tion causes the DE register pair to be loaded with the 16 bit number 
1, i.e. a 1 with fifteen leading zeros. 
The precise meanings of all mnemonics 
in example 4-1 are not im- 
portant 
now, so don't 
let the apparent 
complexity 
of the listing in- 
timidate 
you. Some of the things in the instruction 
field are not in- 
struction 
mnemonics 
at all. ORO and END are directives which tell 
the assembly 
program 
how to assemble 
the source program. 
The 
meanings 
of ORO and END are fairly obvious. 
ORO (origin) tells 
the assembly program 
where in memory the assembled 
instructions 
are to start. END is simply a flag to the assembler that there are no 
more lines to be processed. 
So far we have discussed the label, instruction 
and operand 
fields. 
There is another 
field whose use is optional. 
This is the comments 
field to the far right of the listing. As its appearance 
might suggest, it 
is simply a way for the programmer 
to make notes to himself about 
what is going on in the program 
at this point. 


Besides processing symbols into a machine language program, 
the 
assembler 
is capable of detecting certain types of clerical errors in a 
program. 
The assembler has no way of knowing whether the logic of 
a program 
is correct, 
but it detects and warns the programmer 
of 
certain conditions. 
There were no detectable 
errors in example 4-1, 
but the assembler 
did flag certain lines with a dollar sign ($). This 
dollar sign is a warning 
to the programmer 
that the instruction 
he 
has written will run only on the Z80, not on the 8080. An assembly 
with some actual errors is shown in example 4-2. 


PAGE 01 


001 
- 0 
I 5 A 5 T E R 
002 
ORG 
:2000 


003 2000 3A~620 
@ 
LOA 
0 
5 
004 2003 000000 
STA 
,., 


U 
005 2006 00 
Q 
--- 
006 2007 00000000 
~uzz 
0 
007 
200B 
1800 
BRA 
:30"0 


A 


00M 2000 21C2CI 
LXI 
H~ 'AM 
t 
0092010 
210000 
LXI 
HI 
"AMC' 
L 


010 2013 00 
MOV 
T .•M 
R 
011 2014 DD7E00 
LAX 
300 


D 


.,122017 050AC7 
DATA 
5 .• :A .• 'G' 


013 201A 
DATA 
@78 
U 
014 201A FE00 
CPI 
L 


015 201C 
END 
........................... 
_SYMBOL 
TABLE_ 
........................... 


This listing shows some of the errors which the assembler detects, 


as well as other assembler features. 
The first line, which contains an 
asterisk (*) as the first character 
of the label field is all commentary. 
Any line which begins with an asterisk is printed in the assembly list- 
ing as is but otherwise ignored by the assembler. 
The next line, ORG 
:2000 tells the assembler 
that the program 
is to be located at hexa- 
decimal memory 
address 2000. The colon which precedes the 2000 
indicates that the number is hexadecimal. 
A similar operand appears 
in line 7. On line 3 while the LDA 
Q part of the line is legal, the la- 
bel field contains 
only an "at" 
sign (@). Since a label must begin 


with an alphabetic 
character 
this label is not acceptable to the assem- 


bler. This is noted on the next line by the "S" 
(for symbol) flag. Line 
4 is correct in form, but the operand 
M has not been defined by use 


in a label field anywhere in the program. 
The assembler thus cannot 
assign an address to the STA instruction. 
M is said to be undefined 
in 


this case, this being flagged by the "U" 
on the next line. Line 5 con- 
tains no errors. The triple asterisk assembles as a word of zeros, and 
would be entirely equivalent to the statement: 


The use of a triple asterisk is a means of visually flagging cells which 
are modified by the operating 
program. 
Line 6 contains the instruc- 
tion FUZZ. The problem here is that there is no such instruction 
on 
the 8080 or Z80. This is flagged on the next line with "0", meaning 
operation 
error. 
Line 7 contains 
a legal Z80 (but not 8080) instruc- 
tion. The problem is that this instruction 
has a limited area of mem- 
ory in which it can work and the specified address (:3000) is outside 
this area. The "A" 
flag on the next line indicates this addressing 
er- 
ror. Lines 8 and 9 contain the same legal instruction. 
Line 8 is cor- 
rect, but line 9 specifies' 
ABC' as part of its operand. 
This part of 
the operand 
is limited to 16 bits, the operand 
is too long to fit into 
the allotted 
space. This is indicated 
by the "L" 
(for length) flag on 
the next line. Line 10 contains 
a legal 8080 and Z80 instruction, 
MOV. MOV means move data, 
either between registers or between 
memory and registers. The problem is that there is no such thing as a 
T register. 
This results in the "R" 
flag, meaning register specifica- 
tion error. Line 11 contains 
a Z80 instruction 
which refers to the X 
register. This instruction 
requires an operand, 
called a displacement 
in this case, in the range + 127 to -128. Since the 300 is out of this 
range the instruction 
is flagged with a "D" 
for displacement 
error. 


Line 12 contains 
no errors, 
but shows the assembler's 
ability to 
generate various types of data. The DATA in the instruction 
column 
is not an instruction 
at all, but something 
called a pseudo operation 
or more commonly, 
a pseudo-op. 
DATA allows the generation 
of 
program 
constants 
in a number 
of forms. The number 
of operands 
of a DATA pseudo-op 
is variable, 
and operands 
are separated 
by 
commas. 
The first operand, 
5, is a simple decimal constant. 
The sec- 
ond begins with a colon, like the :2000 and :3000 in the lines above. 
The colon specifies that the number 
which follows is hexadecimal. 


The third is a single character 
set off by apostrophes, 
the letter G. 
This generates the ASCII code for the letter G, which is 110001112 or 
C716• Look at the column of the listing immediately 
to the left of the 
label field and the hexadecimal 
representations 
of all of these con- 


stants can be seen. This field shows the results of assembly of the 
source statement on that line, but we will return to this in a moment. 
Line 12 is another DATA statement. The "at" 
sign (@) before the 
operand specifies that the operand itself is supposed to be octal or 
base eight. This operand contains the digit 8, however, and there is 
no digit 8 in the octal system, so the line is flagged with a "U" 
for 
unknown field type. Line 14 has the same problem as line 9, but this 
time the operand is too short. The apostrophes are supposed to en- 
close a character but they don't, 
so this too is flagged as a length 
(L) error. 


Some further features of an assembly listing and capabilities of 


the assembly program are shown in example 4-3. 


001 
002 
003 03E8 0606 
004 03EA AF 
005 03EB 21F503 
006 03EE 86 
007 03EF 23 
008 03F0 
10FC 
009 03F2 32FB03 
010 03F5 01030507 
011 03FA 0B 
012 03F!l00 
013 03FC 


GRAND 
EQU 
ORG 
SUM 
MVI 
ZAR 
LXI 


LOOP 
ADD 
INX 
DBNZ 
STA 
BEGIN 
DATA 
END 
DATA 


ANSW£R 
••• 
END 


1000 
GRAND 
B,END-BEGIN+I 
COUNT 
TO B 
CLEAR 
A 
ADDRESS 
TO H&L 


ADD 
ARRAY 
MEMBER 


INCREMENT 
ADDRESS 
POINTER 
AGAIN 
IF COUNT 
NOT 
ZERO 


H"BEGIN 
M 
H 
LOOP 
ANS_ER 
1.,315.,7,,9 
11 


•••••• *.*.* ••• *****.*.****. 
• S Y M B 0 L 
TAB 
L E • 
•.••...•••................. 


We will skip over the first two lines of this listing for the moment, 
while we discuss details about the rest of it. Look at the column im- 
mediately to the right of the line number column. The hexadecimal 
number in this column is the memory address to which the first word 
of the instruction on this line has been assigned by the assembler. If 
a label has been used on the line, this value is assigned to that label. 
Look into the symbol table at the bottom of the listing and find the 
label SUM. Immediately to its right is the value of 03E8. In line 6 the 


symbol LOOP has been assigned the value 03EE. Likewise, the sym- 
bols BEGIN and END have been assigned values 03F5 and 03FA. 


Since these symbols have numerical values in the assembly, these 
values can be manipulated and the program in example 4-3 uses this 
manipulation. 
This program 
adds the values of the six numbers 
starting at BEGIN and going to END. While we have not yet covered 
enough material here to show exactly how it works, it should be fair- 
ly obvious that a count of six must be generated somewhere. The in- 
struction in line 3 loads the Z80's B register with the value of the op- 
erand field after the comma, i.e. the value of: 


The value of this operand can be determined easily by substituting 
the values from the symbol table for the symbols. The expression 
above then becomes: 


If you work out the value of this by performing the hexadecimal sub- 
traction and adding the one, it comes out to six, the number of num- 
bers to be added. The usefulness of this might not be immediately 
obvious, but think what would happen if the length of the table to be 
added was to change. Not only would the number have to be inserted 
in the table, but the count would have to be changed. Generating the 
count symbolically as in example 4-3 allows the assembler to take 
care of the clerical detail of adjusting the count. 


A very important 
feature of example 4-3 is on the first line, the 
one with EQU in the instruction field. Up until now the only way to 
give a symbol a value has been to use it in the label field of an in- 
struction. This is different, however. The EQU (equals) generates no 
words in the program. 
It is simply a directive to the assembler to 
consider the value of GRAND to be 100010 (03E816). 
On the very next 
line the symbol GRAND is used in the operand field of an ORG, the 
directive which tells the assembler where this program is to go in 
memory. The result is that the first word of the program is assem- 
bled at 03E816• 
The rules of the assembly program are fairly simple and need not 
be all memorized at once. They will be mentioned as required in the 


text. One thing that should be cleared up before going further is the 
rule for forming labels. A label may be a string of from one to six 
characters of which the first must be alphabetic. The remainder may 
be any characters whatever except plus (+), 
minus (-), or comma. 
Deviations 
from these rules will draw a nasty message from the 
assembler. 
There is one difference between our assembler and some other cur- 
rent ones that needs to be emphasized. There are no reserved names 
in the assembler. By this we mean that a name is not excluded from 
being used as a label because it accidentally may mean something 
else in another context. In many assemblers the names of machine 
registers may not be used as labels, Le., they are reserved for assem- 
bler use. No name which satisfies the rules set out in the paragraph 
above is excluded. If you want to name something A or Be or HL go 
ahead and do it. 


Finally, don't be intimidated by the seeming complexity of all this. 
With a little practice the uses of these features of the assembly pro- 
gram will become clear. The key to learning assembly level program- 
ming is practice and lots of it. In a very real way the sum of your 
knowledge will be the sum of all your experience, both successful 
and unsuccessful. Making mistakes is important, 
since more learn- 
ing takes place in tracking down mistakes than in simply running 
successful programs .. 


5 I 
USING THE 
ASSEMBLYPROGRAM 


"Though this be madness, yet there is method in it:' 


William Shakespeare 
Hamlet 
Act II 


Now that we know something 
about the assembly language itself 
and how it looks, 
we can turn to the practical 
problem 
of how to 
use it. 
The assembler 
listed in appendix 
B of this book will run on any 
8080 or Z80 computer 
system with enough memory 
to hold it. The 
only difference between systems that will concern us here is in the de- 
tails of the input and output processes. If you have not already done 
so, this is the time to go to the appendix and make such adjustments 
to the input and output routines as are necessary to make the assem- 
bler run on your configuration 
of equipment. 


Source 
programs 
are prepared 
for 
assembly 
using 
a program 
known as a text editor. The text editor is, in this case, built into the 
assembler 
and functions 
as a part of it. It is the simplest possible 
program, 
with the minimum 
number 
of commands, 
that 
will do 
what is required 
of it. This has been done deliberately 
to minimize 
the overhead 
of mental clutter which must be forced on the begin- 
ning programmer. 
The text editor uses memory space beyond the end of the assem- 
bler to hold the text of the source program 
being developed. 
The ba- 
sic unit of text is a line. This simple text editor always handles infor- 
mation 
a line at a time. The text lines can thus be viewed somewhat 
like old fashioned 
printers' 
type slugs. Each slug represented 
an en- 
tire line, the top slug being line one, the next line two and so forth. If 
a slug were added after line five, the former line six became line sev- 
en, the former 
line seven became 
line eight, 
etc. The text editor 
works in an exactly analogous 
way. The area of memory 
in which 
the text is held is known as the source buffer. 


The text editor is started by setting the program counter of your 
computer to the beginning location of the assembler and starting the 
computer. 
The terminal device carriage will return and the greater 
than symbol (» 
will be printed. The greater than symbol signifies 
the editor's readiness to accept a command. Let's suppose we want- 
ed to enter the text MARY HAD A LITTLE LAMB into the source 
buffer. Entry of text into the buffer is done with the A command. 
Every text editor command is terminated by a period. Typing A. af- 
ter the "greater than" symbol allows the text editor to accept materi- 
al to be entered into the buffer. Each line is then typed ending with a 
carriage return. When you have finished typing the lines type a peri- 
od as the first character of a new line and control will return to the 
text editor, ready to accept another command. The entry of MARY 
HAD A LITTLE LAMB looks like this. 


MARY 
HAD 
A 
LITLE 
LAMB 


If an error is made in typing under control of the A command, it can 
be corrected by using the back arrow (-). 
Typing back arrow has the 
effect of erasing the character typed just before the back arrow. It 
can be used to backspace over any number of characters this way, to 
reach a mistake made early in the line. The correct text from the 
point of error may then be typed. If the back arrow is typed as the 
last character of a line, Le., just before the carriage return, the entire 
line is ignored. 


We have entered each word on a different line for a reason which 
will become clear in a moment. There are five lines in the source buf- 
fer. The text editor can be made to display any of these lines by 


means of the L (list) command. 
The L is followed by the number of 
the line to be listed. Typing L2. results in: 


>L2 • 
0002 HAD 


The line is listed and another 
"greater 
than" 
character typed, mean- 
ing that the editor is ready for another 
command. 
If more than one 
line is to be listed, the beginning and ending line numbers are sepa- 
rated by a space. To list lines 2 through 4: 


>L2 4. 
0002 
HAD 
0003 
A 
0004 LITLE 


>Ll 
5. 
0001 MARY 
0002 HAD 
0003 
A 
0004 LITLE 
0005 
LAMB 


This is easy enough, since the text in the buffer is only 5 lines long. 
In editing long texts, however, 
it is very easy to lose track 
of the 
number of lines in the buffer. Keeping track of this number is a nui- 
sance so the text editor does it for you. The use of the letter F as a 
line number means the final line of the buffer, whatever it is. The en- 
tire buffer contents can be typed out by: 


>Ll 
F. 
0001 
MARY 
0002 
HAD 
0003 
A 
0004 
LITLE 
0005 
LAMB 


>LF. 
0005 
LAMB 


We have a problem here, however. Most readers will have noticed by 
now that there is a misspelled word on line 4. Line 4 can be gotten rid 
of by the D (delete) command, Le.: 


>D4. 
> 


>Ll 
F. 
0001 
MARY 
0002 
HAD 
0003 
A 
0004 
LAMB 


Note that with line 4 gone, the former line 5, LAMB, has become 
line 4. If we had deleted line 1 instead, all of the succeeding lines 
would have been automatically renumbered. Now to get line 4 back 
in, this time properly spelled. To do this we again use the A com- 
mand, but this time with a line number. The effect of using A with a 


line number is to add the typed in text after the line named in the A 
command. Thus the new line is to be inserted after line 3 of the exist- 
ing text, i.e.: 


>L1 
F. 
0001 
MARY 
0002 
HAD 
0003 
A 
0004 
LITTLE 
0005 
LAMB 


Now suppose that something had to be added to the end of this 
text. The A command can be used with F for a line number just as 
the L command was. We can add lines by: 


AND 
BOY 
WAS 
THE 
DOCTOR 
UPSET 


>Ll 
F. 
0001 
MARY 
0002 
HAD 
'1'103A 
0004 
LITTLE 
0005 
LAMB 
'1006 AND 
0007 BOy 
0008 
wAS 
0009 
THE 
0010 
DOCTOR 
0011 
UPSET 


>DF. 
>D4 9. 
> 


>Ll 
F. 
0001 
MARY 
0002 
HAD 
0003 
A 
0004 
DOCTOR 


The buffer contents can be punched onto paper tape for reuse la- 
ter by means of the P command. P works just like L except that the 
text is sent to the system paper tape device instead of the terminal de- 
vice. Also there are no line numbers on the paper tape. The contents 
of the entire buffer can be punched by: 


After the period is typed the computer will pause until the space bar 
is struck. The buffer will be punched out and the computer will 
pause again waiting for the space bar. Striking the space bar this sec- 
ond time causes a "greater than" character to be printed and the edi- 
tor is ready to accept another command. 
The tape so produced can be reloaded into the buffer by the R 
(read) command. This reads lines from the system paper tape read 
device and adds them to the end of whatever may already be in the 
buffer. Suppose that the buffer contained: 


>L1 
F. 
0001 
SUZY 
0002 
HAD 
0003 
A 
0004 
LAwYER 


and the tape just punched were read by the R command. The re- 
sult is: 


>L1 F. 
0001 
SUZY 
0002 
HAD 
0003 
A 
0004 
LAWYER 
0005 
MARY 
0006 
HAD 
0007 
A 
0008 
DOCTOR 


>Ll 
F. 
0001 
SUZ'/ 
0002 
HAD 
0003 A 
0004 
LAWYER 
0005 
AND 
0006 
MARY 
0007 
HAD 
0008 
A 
0009 
DOCTOR 


If the tape to be read represents an entirely separate piece of text, 
Le., a new program, the buffer must first be cleared. This is accom- 
plished by the / command, Le.: 


Using the text editor to type in programs differs little from what 
has already been illustrated in this chapter. Some special abilities of 
the text editor come into play here however. Turn back to example 
4-1 for a moment and notice that the columns are aligned. This align- 
ment is automatic. 
The programmer 
does not need to count out a 
number of spaces before beginning to type the instructions. 
If the 
line begins with a blank, a blank label field is implied and the text ed- 
itor will supply the necessary spacing. Likewise, the text editor can 
recognize which instructions require operands and which do not. In 
listing instructions 
which require no operand, 
the operand field is 
left blank and any nonblank text following the instruction is moved 
to the comment field. This is better understood in the form of an il- 
lustration 
rather than further discussion. The program in example 
4-1 is typed in like this: 


>/ • 
>A. 


* SQUARE 
ROOT 
PROGRAM 
ORG 
:11313START 
HEREI 
BRUNHILDE 
LHLD 
N 
GET 
NUMBER 
LXI 
Dl1 
1ST 
ODD 
INTEGER 
TO 
D-E 
RSC 
CLEAR 
CARRY 
LOOP 
DSC 
D 
SUBTRACT 
ODD 
INTEGER 
BC 
END 
CROSS 
ZER01 
INX 
D 
NOI 
FORM 
NEXT 
ODD 
INX 
D 
INTEGER 
BRA 
LOOP 
AND 
DO 
IT 
AGAIN 
END 
LRD 
DOUBLE 
SHIFT 
THE 
RER 
RESULT. 
ROOT 
IN 
E 
REG. 
HER E 
JMP 
HER E 
N DEL 
65535 
END 


>L1 
F. 
1313131* SQUARE 
ROOT 
PROGRAM 
1313132 
ORG 
:11313 
START 
HERE .• BnUNHILDE 
1313133 
LHLD 
N 
GET 
NUMBER 
1313134 
LXI 
D .•1 
1ST 
ODD 
INTEGER 
TO 
D-E 
1313135 
RSC 
CLEAR 
CARRY 
1313136LOOP 
DSC 
D 
SUBTRACT 
ODD 
INTEGER 
1313137 
BC 
END 
CROSS 
ZERO? 
1313138 
INX 
D 
NOI 
FORM 
NEXT 
ODD 
1313139 
INX 
D 
INTEGER 
12113113 
BRA 
LOOP 
AND 
DO 
IT 
AGAIN 
131311END 
LRD 
DOUBLE 
SHIFT 
THE 
01312 
RER 
RESULT. 
ROOT 
IN 
E 
REG. 
0013 
HERE 
JMP 
HERE 
01314 N 
DBL 
65535 
131315 
END 


The text editor has automatically 
reformatted 
each instruction 
for 
easier reading. 
Note in lines 2, 3 and 4 that the operand 
field has 
been filled in. In line 5, however, the operand has been omitted. RSC 
is a synonym for another instruction 
which has the effect of resetting 
(turning oft) the carry bit. The point here is that it requires no oper- 
and. Anything which follows it must be commentary 
and the text ed- 
itor recognizes this. 
The programmer 
is thus 
freed 
from 
the nuisance 
of counting 
spaces to align the various fields of a source statement. 
This is an im- 
portant 
feature. 
Programming 
is a demanding 
task which tolerates 
no error, 
and automatic 
elimination 
of a possible source of error 
makes the task that much easier. 
We have already noted two ways in which comments 
can be writ- 
ten into a program, 
beginning the line with an asterisk and using the 
short comment 
field of the source line. There is a third way which 
has a good deal to recommend 
it, the REM pseudo-op. 
Suppose a 
comment was started in the comment field of an instruction, 
and the 
comment was too long. Normally, 
it would be continued 
by starting 
the next line with an asterisk, allowing the entire next line to be used 
for commentary. 
This makes for difficult 
reading. 
If the following 
line is typed with REM in the instruction 
field the commentary 
which 
follows the space after the REM will be aligned with comments field 
of the instruction 
above it, making the entire commentary 
a neat, 
easy to read block. Suppose the instruction 
in line 7 of example 4-1 
required more explanation 
than just "CROSS 
ZERO?". 
It could be 
written this way: 


Be 
END THE 
CARRY 
BIT 
GOES 
ON 
REM 
WHEN 
THE 
RESULT 
OF THE 
REM 
SUBTRACTION 
GOES 
FROM 
REM 
POSITIVE 
TO 
NEGATIVE 


>LI 
F. 
0001 
• 
0002 
0003 
0004 
0005 
0006 
LOOP 
0007 
0008 
0009 
0010 
0011 
0012 
0013 
0014 
END 
0015 
0016 
HERE 
0017 
N 
0018 


SQUARE 
ROOT 
ORG 
LHLD 
LXI 
RSC 
DSC 
BC 
REM 
REM 
REM 
INX 
INX 
BRA 
LRD 
RER 
o.lMP 
DBL 
END 


PROGRAM 
:100 
N 
D,I 


START 
HERE, 
BRUNHILDE 
GET 
NUMBER 
1ST 
ODD 
INTEGER 
TO 
D-F 
CLEAR 
CARRY 
SUBTRACT 
ODD 
INTEGER 
THE 
CARRY 
BIT 
GOES 
ON 
WHEN 
THE 
RESULT 
OF 
THE 
SUBTRACTION 
GOES 
FROM 
POSITIVE 
TO 
NEGATIVE 
NO, 
FORM 
NEXT 
ODD 
INTEGER 
AND 
DO 
IT AGAIN 
DOUBLE 
SHIFT 
THE 
RESULT. 
ROOT 
IN 
E REG. 


D 
D 
LOOP 


and in the assembly listing looks like this: 


PAGE 
01 


001 
• SQUARE 
ROOT 
PROGRAM 
002 
ORG 
:100 
003 
0100 
2AI601 
LHLD 
N 
004 
0103 
110100 
LXI 
D,I 
005 
0106 
B7 
RSC 
006 
0107 
ED52 
$ 
LOOP 
DSC 
D 
007 
0109 
3804 
$ 
BC 
END 
008 
009 
010 
011 
010B 
13 
INX 
D 
012 
010C 
13 
INX 
D 
013 
010D 
18F8 
$ 
BRA 
LOOP 
014 
010F 
CB3A 
$ 
END 
LRD 


.,15 
0111 
CBIB 
$ 
RER 
016 
0113 
C31301 
HERE 
J~P 
HERE 
017 
0116 
FFFF 
N 
DBL 
65535 
018 
0118 
END 


••••••••••••••••••••••••••• 
• SYMBOL 
TAB 
L 
E 
• 
••••••••••••••••••••••••••• 


END 
010F 
HERE 
0113 
LOOP 
0107 
N 


START 
HERE, 
BRUNHILDE 
GET 
NUMBER 
1ST 
ODD 
INTEGER 
TO 
D-E 
CLEAR 
CARRY 
SUBTRACT 
ODD 
INTEGER 
THE 
CARRY 
BIT 
GOES 
ON 
WHEN 
THE 
RESULT 
OF 
THE 
SUBTRACTION 
GOES 
FROM 
POSITIVE 
TO 
NEGATIVE 
NO, 
FORM 
NEXT 
ODD 
INTEGER 
AND 
DO 
IT AGAIN 
DOUBLE 
SHIFT 
THE 
RESULT. 
ROOT 
IN E 
REG. 


Note that the REM's 
themselves 
are blanked 
out in the assembly 
listing. 


The assembly process itself is initiated 
by the # command, 
with a 
modifier. 
If #L. is typed a full assembly listing is printed on the sys- 
tem listing device, producing 
the result just shown. 
If #E. is typed 
the program 
is assembled but only lines which contain errors are list- 
ed. This is an extremely useful option, 
allowing the program 
to be 
scanned for misspelled instructions 
and other typing errors without 
waiting for an entire assembly listing to be printed. 
The result of us- 
ing #E. with the program 
of example 4-2 in the buffer is: 


003 2000 
3A0620 
@ 
LDA 
Q 
S 
004 2003 
000000 
STA 
M 
U 
006 2007 
00000000 
FUZZ 
0 
007 2008 
1800 
$ 
BRA 
:3000 
A 
009 2010 210000 
LXI 
H, •ABC' 
L 
010 2013 
00 
MOV 
T,M 
R 
011 2014 DD7E00 
$ 
LAX 
300 
D 
013 201A 
DATA 
@78 
U 
014 201A FE00 
CPI 
•• 
L 


Only the lines containing 
errors 
are listed. The program 
can then 
quickly be repaired 
using D and A commands. 
A full assembly list- 
ing need only be made when all of these clerical errors 
have been 
eliminated. 
The third assembly 
mode is selected by typing #0. 
This is "oh" 
not zero. This causes an object program 
to be punched 
out on the 
system paper tape punch device, with about six inches of blank tape 
at either end. The program 
pauses at both the beginning 
and end of 
punching 
to allow the punch to be turned on and off. This is to ac- 
commodate 
systems in which all of the functions 
are performed 
by a 
single device like a Teletype®. 


The tape 
which 
is produced 
by the #0. 
command 
is a machine 
language 
version 
of the source 
program. 
The contents 
of this tape 
can be loaded 
into computer 
memory 
and executed 
under 
control 
of 
the debugging 
monitor 
in appendix 
C. The loading 
of the tape and 
execution 
of the program 
under 
control 
of the debugging 
monitor 
are described 
in chapter 
17. 
A fourth 
assembly 
mode 
is entered 
by the #Z. command. 
This 
mode scans for and prints lines which contain 
Z80 only instructions, 
Le., instructions 
which are not part of the 8080 set. This assembly 
mode is provided 
to allow easy scanning 
for Z80 instructions 
in pro- 
grams which must maintain 
compatibility 
with the 8080. 
A summary 
of all text editor/assembler 
commands 
and means 
for 
assembling 
programs 
which are too long to fit in memory 
are given 
in appendix 
B. 
Finally, 
the assembler 
allows each page of the assembly 
listing to 
be headed with any text of the programmer's 
choice. Look at the list- 
ing of the debugging 
monitor 
in appendix 
C. The heading: 


printed 
on the same line as the page number 
was specified 
by a TITL 
pseudo-op. 
If TITL appears 
anywhere 
in a source program, 
the con- 
tents of its operand 
field, up to 36 characters, 
will be used as a head- 
ing for each page. If more than one TITL appears 
in a program 
only 
the last one to appear 
is effective. 
Having 
now completed 
the discussion 
of these mechanical 
details 
we can proceed 
to the real business 
of this book - 
learning 
to pro- 
gram the Z80 computer. 


6 I 
MOVING 
DATA WITH 
zao INSTRUCTIONS 


"He bought a large map representing the sea 
Without the least vestige of land; 
And the crew were much pleased when they found it to be 
A map they could all understand!' 


Lewis Carroll 
The Hunting of the Snark 


All activity which takes place in a computer revolves around the 
movement of data, between registers and memory, register to regis- 
ter, or between the computer and the outside world. The Z80 com- 
puter provides a number of modes of data movement approached by 
no other eight bit microcomputer, 
and it is in these modes that the 
power ofthe Z80 lies. 


Data may be moved between registers and memory in a variety of 
ways. The movement of data from memory to a register or register 
pair is known as loading. Movement of data from a register or regis- 
ter pair to memory is known as storing. These terms are quite specif- 
ic in meaning and represent the common practice of the program- 
ming craft. They are fundamental 
and must be memorized before 
any further progress can be made. When the data movement can oc- 
cur in either direction the general term move is used. 
The simplest kind of data movement is direct loading and storing. 


The Z80's A register can be loaded from memory and stored into 
memory by means of the LDA and STA instructions. A simple use of 
these instructions is shown in example 6-1. 


JAIL. Use the LDA and STA instructions 
to move DICKY 
to JAIL. 


inst. 
LDA 
operand 
DICKY 
contents of DICKY to 
A register 
store A register in JAIL 


Register pairs may be loaded and stored directly by the following 
instructions: 


LHLD 
SHLD 
LBCD 
SBCD 
LDED 
SDED 
LXD 
SXD 
LYD 
SYD 


LoadH 
and L 
Store Hand 
L 
LoadBandC 
Store Band C 
Load DandE 
Store D and E 
Load X 
Store X 
Load Y 
Store Y 


Another 
16 bit register, 
named SP, can be loaded and stored di- 
rectly by means of LSPD and SSPD, but we will come to this later. 
Just as with LDA and STA in example 6-1, the register pair loads and 
stores must specify the operand. 
A simple exercise with some of 
these registers is shown in example 6-2. 


Use the register pair load and store instructions 
discussed 
above to exchange the contents of the BC and DE registers 
pairs. The idea here is that the contents 
of BC end up in 


DE and vice versa. This is done by using memory locations 
to hold the registers' 
contents. 
Both register pairs are 
stored, then reloaded with each other's 
contents. 
Since 
register pairs are being stored, two words must be allowed 
fn memory for each of the stores. A convenient way to cre- 
ate a two-word space is: 


label 
inst. 
operand 
HENRY 
DBL 
0 
reserve 2 words under 
the name HENRY 
ALICE 
DBL 
0 
and 2 under the name 
ALICE 


With the temporary 
storage 
words defined 
under 
the 
names HENRY and ALICE we can proceed with the ex- 
change of the register contents. 


SWAP 
SBCD 
HENRY 
save BC contents 
in HENRY 
SDED 
ALICE 
save DE contents 
in ALICE 
LBCD 
ALICE 
load BC from ALICE 
LDED 
HENRY 
and DE from HENRY 


It needs to be emphasized that this is merely an illustration 
of the use of these instructions. There is a much better way 
to accomplish the same thing using the Z80's stack which 
will be shown in a later example. 


Data are also moved in the Z80 by the use of register pair pointers. 
These pointers are similar in function to that discussed for the pro- 
gram counter in chapter 3. Recall that the program counter was said 
to "point to", i.e., contain the address of, the next instruction to be 
fetched from memory. A register pair may be used in a similar way 


to "point 
to" a memory 
location 
to be accessed. 
There are a number 
of modes in which this can be done. The most fundamental 
involves 
the use of the HL register pair. 
If the HL register pair contained 
the 
hex number 
2AC4, then the instruction: 


will load the contents 
of memory 
location 
2AC4 into the A register. 
The other single registers, 
B, C, H, L, D, and E can also be loaded in 
this way, Le.: 


MOV 
B,M 
MOV 
e,M 
MOV 
H,M 
MOV 
L,M 
MOV 
D,M 
MOV 
E,M 


Note the order of specification 
of the operands, 
first the destination, 
then 
the 
source. 
Note 
also 
that 
the 
combinations 
MOV 
H,M 
and 
MOV 
L,M 
are not useful, 
since they destroy the HL 
pointer 
being used to move the data. 
Any of the single registers 
may also be stored into memory 
by sim- 
ply reversing 
the order of the operands, 
Le.: 


stores the contents 
of A into the memory 
location 
pointed 
to by HL, 
while the combinations: 


MOV 
M,B 
MOV 
M,e 
MOV 
M,H 
MOV 
M,L 
MOV 
M,D 
MOV 
M,E 


store 
the contents 
of the named 
registers 
in the memory 
locations 
pointed 
to by HL. Again 
MOV 
M,H 
and 
MOV 
M,L 
com- 


binations are not useful. What must be remembered here is the order 
of the operands for a MOV, first the destination, 
then the source, 
i.e.: 


The combination 
MOV 
M,M 
is forbidden 
and will be flagged 
by the assembler as an error. 
The MOV instruction can also be used to transfer data between 
registers. The operands of the MOV are the two registers, e.g.: 


transfers the contents of the L register to the B register. Again, the 
order of operands is destination, 
then source. These register moves 
are illustrated in example 6-3. 


Using the A register as temporary storage, swap the con- 
tents of the L register with those of the C register. The 
method is the same as that of example 6-2. First we copy 
one of the registers, say L, into the temporary 
storage 
space (A). The second register, C, is then moved to L. Fi- 
nally, the temporary word in A is moved to C. 


label 
XCL 
ins!. 
MOV 
MOV 
MOV 


operand 
A,L 
L,C 
C,A 


save L contents in A 
transfer C contents to L 
former L contents to C 


MOV 
MOV 
MOV 


A,C 
C,L 
L,A 


save C contents in A 
transfer L contents to C 
former C contents to L 


In summary, MOV may be used to move data between registers, 
or between registers and memory. The direction of data movement is 
specified as destination, then source. If either operand of a move is 
specified as M, the data movement takes place between the register 
named as the other operand and the memory word pointed to by the 
16bit number in Hand L. 
Yet another addressing mode allows pointers held in the BC and DE 
register pairs to be used in the transfer of data between memory and 
the A register, but only the A register. This is done with the LDAX 
and STAX instructions. The operand of an LDAX or STAX consists 
of a single character, B or D, specifying either the BC or DE register 
pair as the pointer. The use of this mode is shown in example 6-4. 


Assume that the BC register pair contains the address of 
(points to) a memory location named CONGRS and that 
the DE register pair contains the address of (points to) a 
memory location named MONEY. Use LDAX, STAX and 
MOV instructions 
to exchange the contents of CONGRS 
and MONEY. 


label 
inst. 
operand 
MSWAP LDAX 
B 
CONGRS to A register 
MOV 
H,A 
save it in H 
LDAX 
D 
MONEY to A register 
STAX 
B 
store MONEY 
inCONGRS 
MOV 
A,H 
now retrieve CONGRS 
from H 
STAX 
D 
and store it in MONEY 


The swap can be done in the opposite order, of course, as 
in example 6-3. 


A.n even more versatIle method of data movement 
is available by 
using the X and Y registers. Data may be loaded into any single reg- 
ister through a pointer held in X or Y via load instructions 
of the fol- 
lowing form: 


to load the A register 
with the contents 
of the memory 
location 
pointed to by X. B would be loaded through the pointer in Y by: 


We will get to the zeros in the operand fields in a moment. 
Storing is 
accomplished 
by instructions 
of the form: 


to store L in the location pointed to by Y. To avoid the awkwardness 
of the expressions 
"pointed 
to" and "via the pointer contained 
in" 
we will hereafter 
use the nomenclature 
through. Thus the instruc- 
tion: 


stores the E register through Y. It must be clear, however, 
that the 
data do not actually travel through the pointer register. 


The instructions 
which load and store through 
X and Y illustrated 
above all had operand 
fields of zero. The number 
in the operand 
field is known as a displacement. 
Instructions 
like LAX and SLY 
which reference memory through the X and Y registers are said to be 
indexed instructions, 
and the X and Y registers themselves 
are re- 


ferred to as index registers. The displacement of an indexed instruc- 
tion is added to the contents of the index register before memory is 
actually accessed. If the displacement of LBY were a 3, the effect 
would be to load the B register with the contents of the memory 
word whose address was 3 greater than that pointed to by Y. This 
does not change the contents of Y.The computation of the final ad- 
dress of the memory word involved is done internally and Y (or X) is 
not changed. This has a great many applications and its judicious 
use can simplify a number of programming tasks. 
The displacement of an indexed instruction need not be a numeri- 
cal constant. Suppose we were working on a hardware inventory 
problem in which successive memory locations contained the num- 
ber of nuts, bolts, nails, screws and pins. Using the EQU pseudo-op 
a table of equivalences can be created: 


NUTS 
EQU 
0 
BOLTS 
EQU 
1 
NAILS 
EQU 
2 
SCREWSEQU 
3 
PINS 
EQU 
4 


These names can now be used as equivalent to the numbers they rep- 
resent. If the Y register were loaded to point to the words containing 
the count of nuts, the instruction: 


and the first instruction is more meaningful in terms of the problem 
to be solved. Further, the instruction: 


is the same as 
LBY 
3, but the programmer is relieved of the task 
of remembering where the count of screws is stored every time he 
wants to work with it. Even more important, such a program will be 


accessing these locations 
in many places. 
If the locations 
ever 
change, the program can only be updated by changing every refer- 
ence to the numerically defined displacements. 
If the displacements 
are defined in terms of symbols as shown, however, only the small 
table of EQUs needs to be changed, and the assembler will automat- 
ically correct every reference when the program is reassembled. This 
illustrates a very important programming tactic. Wherever possible, 
make the programming system do the work for you. 
Discussion up until now has centered around pointers contained in 
registers, but how the pointers came to be there has been left unex- 
plained. A pointer is a 16bit quantity. The assembler contains facili- 
ties for the creation of double length constants 
in memory. 
The 
source statement: 


will result in two words being generated which contain the binary 
equivalent 
of 
the 
decimal 
number 
-1000. 
This 
number, 
11111100000110002 is stored in two consecutive words, the low signi- 
ficance half of the number occupying the word with the lower mem- 
ory address. Note that this order is different from that used by some 
other microprocessors. 
Since a label symbol has a numeric value as- 
signed by the assembler this value may be considered to be a i6 bit 
numeric constant. 
A constant of this sort is said to be an address 
constant. The 16 bit address constants for a pair of locations named 
TRISTN and ISOLDE can be created by: 


TPTR 
IPTR 
DBL 
DBL 
TRISTN 
ISOLDE 


would load the address of TRISTN into the HL register pair. There- 
after the contents of TRISTN could be moved to the A register by: 


While is it sometimes 
necessary 
to use address 
constants 
stored 
in 
memory, 
it is usually 
possible 
to get the address 
constant 
into the 
register 
pair another, 
more economical 
way. This involves the use of 
a new addressing 
mode, 
the so-called immediate mode. The operand 
of an immediate 
instruction 
is contained 
within the instruction 
itself. 
This makes 
an ideal way to generate 
program 
constants 
without 
us- 
ing extra memory 
to hold them. 
The A register 
can be loaded 
with 
the number 
-35 by: 


the alphabetic 
nature 
of the constant 
being indicated 
by the apostro- 
phes. Register 
pairs can be loaded 
with 16 bit constants 
as shown in 
line 8 of example 
4-2. To load a register pair with a constant 
the LXI 
instruction 
is used, Le.: 


LXI 
8,1000 
loads Hand 
L with the 
number 
1000 
LXI 
B,O 
clears the BC register 
pair 
LXI 
D,-1 
loads D and E with 
FFFF16 
LXI 
X,:3F7B 
loads X with 3F7BI6 


LXI 
Y,'OK' 
loads Y with the ASCII 
characters 0 and K 


Since a label has a numeric 
value, 
we can generate 
immediate 
ad- 
dress constants 
the same way, so that instead 
of creating 
an address 
constant 
in memory 
as we did above, 
the constant 
can become 
part 
of the instruction 
which loads it. In this way: 


loads 
the address 
of TRISTN 
into the HL register 
pair. 
This saves 
the two words required 
for the constant 
TPTR. 
The use of pointers 
loaded in this way is shown in example 
6-5. 


Using pointers held in the HL and DE register pairs move 
one word of data from ALPHA to OMEGA. 


label 
inst. 
operand 
LXI 
H,ALPHA 
address of ALPHA 
toHL 
LXI 
D,OMEGA 
address of OMEGA 
to DE 
MOV 
A,M 
contents of ALPHA to 
A register 
STAX 
D 
store in OMEGA 


The method of example 6-5 is too longwinded for moving a single 
word of data, of course. If only one word were to be moved it could 
be done more economically and faster with: 


LDA 
ALPHA 
STA 
OMEGA 


The point of moving the data by the method of example 6-5 was to 
introduce the possibility of moving an entire block of data at a time. 
To do this the pointers held in HL and DE need to be manipulated. 
Suppose a five word block of data beginning at METS were to be 
moved to a five word block beginning at PHILS. It could be accom- 
plished by a sequence of LDA and STA instructions, i.e.: 


LDA 
METS 
STA 
PHILS 
LDA 
METS+l 
STA 
PHILS+l 
LDA 
METS+2 
STA 
PHILS+2 


and so forth. 
A better way is to move the data by means of pointers 
which can be changed 
to point to different 
memory 
addresses. 
The 
Z80 has instructions 
which can increment, i.e., increase 
by one, and 
decrement, 
i.e., 
decrease 
by one, each of the pointer 
register 
pairs. 
These instructions 
are: 


INX 
DCX 
INX 
DCX 
INX 
DCX 
INX 
DCX 
INX 
DCX 
INX 
DCX 


B 
B 
H 
H 
D 
D 
X 
X 
y 
y 
SP 
SP 


increment 
BC pair 
decrement 
BC pair 
increment 
HL pair 
decrement 
HL pair 
increment 
DE pair 
decrement 
DE pair 
increment 
X register 
decrement 
X register 
increment 
Y register 
decrement 
Y register 
increment 
stack pointer 
decrement 
stack pointer 


We will have more to say about these last two instructions 
a bit later. 
Before we can move a block of data with pointers, 
there remains 
one 
problem 
to be solved; 
how to control 
the size of the block which is 
moved. 
In this case the size of the block is five, so we want to create 
a count 
of five somewhere 
and 
decrement 
it each time 
a word 
is 
moved, 
stopping 
when the count becomes 
zero. To do this we could 
use the INR or DCR instructions. 
INR addresses 
a single eight bit 
register, 
i.e.: 


adds one to the number 
which is in the A 
register, 
while 
does the same thing 
forC 


subtracts 
one from the 
value in the eight bit H 
register, 
and 


does the same thing 
toD 


At this point we must know something about the F register which has 
remained 
unexplained 
until now. The execution of INR or DCR in- 
structions 
set the flags of the F register to reflect the result of the in- 
crementation 
or decrementation, 
specifically, 
the zero flag or Z bit is 
set if the result of an INR or DCR is zero. The only problem 
which 
remains is to use this flag setting to stop the movement 
of the data. 
The flags are tested and the flow of the program 
changed by means 
of jump or branch instructions. 
The difference 
between a jump and 
a branch is not important 
just now. We will use a branch instruction 
here. The point is that a test is made of a bit in the F register. 
If the 
bit is a one the sequential execution of instructions 
is altered by load- 
ing a new value into the program 
counter, 
this value being specified 
by the operand of the jump or branch. The branch instruction: 


means that if the result of the last operation 
(INR or DCR here) was 
a zero take the next instruction 
from the memory 
location 
whose 
name is AGAIN. 
If the result was not zero, simply take the instruc- 
tion following the BZ. 


The BNZ instruction 
tests on the opposite condition. 
If the result 
of the last operation 
was zero the instruction 
after the BNZ is taken. 


If the result was not zero the next instruction is taken from the location 
named in the operand of the BNZ. 
Other result conditions 
can also be tested by branches. 
If the last 
arithmetic 
operation 
resulted in a carry out of the high bit the carry 
bit in the F register control may be transferred 
to a new location 
by 
means of the BC or BNC instructions. 
The BC branches 
if the carry 
bit is a one. If carry is zero the next instruction 
which follows the BC 
is taken. BNC, meaning branch if no carry, has just the opposite ef- 
fect. The branch 
is taken if carry is a zero. If carry is a one the in- 
struction which follows the BNC is executed. 


If no particular 
condition 
is to be tested control can be transferred 
to a new program 
location 
by a simple BRA (branch) 
instruction, 
l.e. : 


transfers control to NEWLOC under all circumstances. 
We can now put all of this together to move the five word block 
from METS to PHILS. This move is shown in example 6-6. 


Using pointers held in HL and in DE, move the five word 
block of data which begins at METS to the five word 
block which begins at PHILS 
under control of a count 
held in the B register. 


label 
inst. 
operand 
BLMOVE 
MVI 
B,5 


LXI 
H,METS 
LXI 
D,PHILS 


AGAIN 
MOV 
A,M 


STAX D 


INX 
H 


load the constant 5 
intoB 
address of METS to HL 
address of PHILS 
to DE 
move word from METS 
block to A register 
and then to PHILS 
block 
increment METS 
address pointer in HL. 
This makes HL point to 
the next word in the 
METS block 
increment PHILS 
address pointer in DE. 
This makes DE point to 
the next word in the 
PHILS block 
decrement the count of 
the B register. This sets 
the Z bit of the F 
register so that it can be 


tested by the BNZ 
if the result of the DCR 
in the line above was a 
zero, control will pass 
to the instruction which 
follows the BNZ. If the 
result was not zero, the 
next instruction will be 
taken from location 
AGAIN 
program continues here 


It is of crucial importance that the reader understand 
completely 
what went on in example 6-6. Example 6-6 illustrates the all-impor- 
tant principle of looping, the repetitive execution of a section of a 
program under control of a count. If this example is not understood 
now, very little of the remainder of this book will make sense. If you 
are the least bit fuzzy about example 6-6, go back over it until you do 
understand 
it. The importance 
of the looping principle cannot be 
overstressed. 
Example 6-6 showed the movement of data under control of a sim- 
ple count held in B. The example can be shortened by using a Z80 fa- 
cility which combines two 8080 instructions into one, the DBNZ in- 
struction. DBNZ combines the DCR and BNZ instructions. This sin- 
gle instruction 
decrements the B register and performs the branch 
test. The program in example 6-6 would read: 


BLMOVE 
MVI 
B,5 
LXI 
H,METS 
LXI 
D,PHILS 
AGAIN 
MOV 
A,M 
STAX 
D 
INX 
H 
INX 
D 
DBNZ 
AGAIN 


While we have not yet discussed the amount of memory required 
by the various instructions, use of the DBNZ shortens the program 
in example 6-6 by one word. DCR and BNZ together require three 
words, BNZ being two of the three. DBNZ requires only two words. 
It is not always possible to use a branch instruction 
to transfer 
control. The reason for this is that the range over which a branch can 
transfer control is limited. The point to which control is transferred 
by a branch must be within the limits + 127 to -128 of the program 
counter value when the branch is executed. The point to which con- 
trol is transferred by a branch is computed by the Z80 by adding the 
second word of the branch instruction to the program counter. Re- 
call now the earlier emphasis on the value of the program counter. 
The program counter always points to the instruction after the one 
being executed. Since branch instructions 
are two words long this 
means that the location to which control is transferred must be in the 
range + 129 to -126 of the location of the first word of the branch in- 
struction. 
This relatively short range does not allow a branch to 
reach all parts of memory. For this reason the Z80 also has jump in- 
structions. These instructions are three words long, compared to two 
for a branch, but a jump can reach anywhere in memory. The target 
address of a jump is not computed from the program counter but is 
contained directly in the last two words of the instruction. 
In addi- 
tion, jumps may test on more conditions than branches, so they of- 
fer more versatility. The jump instructions are: 


JZ 
jump if zero result 
JNZ 
jump if not zero result 
JC 
jump if carry is a one 
JNC 
jump if carry is a zero 
JV 
jump if an arithmetic overflow has 
occurred 
JNV 
jump if no arithmetic overflow has 
occurred 
JP 
jump if result was positive 
JM 
jump if result was negative 
JMP 
jump unconditionally 


The exact meanings of all these conditions are not important just 
yet. They will become clear as they are used in the examples in fur- 


ther chapters of this book. Two other jumps, JPE and JPO, perform 
the same test as JNV and JV respectively. The mnemonics mean 
jump if parity even and jump if parity odd. Parity refers to the even- 
ness or oddness of the number of one bits in an eight bit group. This 
is of interest to communications 
specialists but will not be of any 
concern to us in this book. Note, however, that JNV and JV are not 
flagged by the assembler as Z80 only instructions ($), being equiva- 
lent to the 8080's JPE and JPO. 
If either a jump or a branch can be used in a situation, 
use the 
branch. If you attempt to branch too far the assembler will let you 
know when you execute the error scan (#E.) by flagging the line with 
an "A", meaning addressing error. The equivalent jump can then be 
easily substituted. 
Going back now to the movement of data, the Z80 has facilities 
for moving blocks of data available on no other current microcom- 
puter. It is possible to move an entire block of data with a single Z80 
instruction, 
and thus to perform the function shown in example 6-6 
with only four instructions 
instead of the nine used there. Using 
pointers held in HL and DE and a 16 bit count held in BC, up to 
65,536 words of memory may be moved by a single instruction. The 
mnemonic for this powerful instruction 
is MW+R, 
the individual 
characters meaning move word increment and repeat. When MW+R 
is executed a number of things happen. 
First the contents of the 
word pointed to by HL are fetched from memory and stored into the 
memory location pointed to by DE. Both pointers, HL and DE are 
then incremented. The BC pair is then decremented. If the result of 
decrementing BC is not zero, the program counter is "backed up" 
and the instruction is repeated, but with the changed values of the 
pointers in HL and DE. Using MW+R the function of the program 
in example 6-6 is shown in example 6-7. 


Using the block move instruction MW+R, move the five 
word block which begins at METS to the five word block 
which begins at PUlLS. 


label 
ins!. 
DLMOVE 
LXI 
operand 
D,S 
load the BC pair with 
the number 
5. Note that 
this load differs 
from 
the one in example 6-6 
in that the constant 
5 
occupies the entire 16 
bit BC pair 
METS pointer 
to HL 
as before 
PHILS 
pointer 
to DE 
as before 
move entire block with 
one instruction 


An interesting 
application 
of this instruction 
is in filling a block of 
memory 
locations 
with some constant 
value. 
To do this the value to 
fill the block is stored into the first word. The length of the block mi- 
nus one is then used as the count in BC. HL is made to point to the 
first word of the block, 
the one already 
containing 
the desired value. 
DE 
is then 
made 
to 
point 
to 
the 
word 
immediately 
following. 
MW+R 
is then executed, 
with the following 
effect. 
The first word of 
the block is transferred 
to the second. 
This is simply 
a copy of the 
first word into the second. 
HL and DE are then incremented 
so that 
they point 
to the second 
and third 
words 
of the block 
respectively. 


BC is decremented 
and if the result of the decrementation 
is not zero 
the process 
is repeated, 
moving 
the second word of the block to the 
third, 
the remainder 
of the block being filled by successive iterations 
of this process. 
A program 
to do this is shown in example 
6-8. 


Using the MW+R 
instruction, 
fill the block 
beginning 
at 
HERE 
and ending at THERE 
with the binary 
value of the 


ASCII character 
"$". THERE 
has a higher memory ad- 
dress than HERE. 


label 
inst. 
operand 
FILL 
LXI 
B, THERE-HERE 
Since both HERE and 
THERE have been as- 
signed values by the as- 
sembler, these values 
can be subtracted 
to 
find the length of the 
block to be filled. The 
value of THERE- 
HERE is actually one 
less than the length of 
the block 
LXI 
H,HERE 
address of beginning of 
block to HL 
LXI 
D,HERE+l 
address of second word 
of block to DE. HL 
now points to the first 
word of the block and 
DE to the second. BC 
contains the number of 
copying operations 
that 
have to be done, Le., 
one less than the block 
length. 
MVI 
A,'$' 
now get the fill value 
MOV 
M,A 
and put it into the first 
word of the block 
MW+R 
copy to rest of block 


This ability to move entire blocks of data is extremely useful in 
writing programs 
such as text editors. The text editor used by the as- 


sembler in appendix B does not use MW+R 
because it was required 
that the assembler run entirely within the 8080 subset of the Z80, but 
it could have been used to great advantage. 
Consider the situation in 
which a line or block of lines has been deleted from the text buffer. It 
is required 
that all text above this, i.e., line numbers 
greater 
than 
those that have been deleted be moved down to fill the gap created 
by the deletion. If the length of remaining text above the deleted por- 
tion is in BC, the address of the first character 
to be moved down in 
HL and the address of the first word of the gap in DE, then the sin- 
gle instruction 
MW+R fills the gap. 
A similar instruction, 
MW-R, meaning move word decrement and 
repeat, moves a block of data just like MW+R, 
but the HL and DE 
pointers 
are decremented 
rather 
than 
incremented. 
This is useful 
when a gap must be created, as when a line is added to a text buffer. 
All of the text above the point at which the material 
is to be added 
must be moved up by an amount equal to the length of the text to be 
added. In this case the count of characters 
to be moved is the length 
of the text beyond the addition point. HL contains the address of the 
last text character 
and DE contains the address to which this charac- 
ter is to be moved, 
i.e., the address 
of the last character 
plus the 
length of the gap which must be created for the new text. When the 
pointers 
and count have been set up this way, the single instruction 
MW-R creates the necessary gap. The new text can then be copied in- 
to the gap with the MW+R instruction. 


The MW+R 
and MW-R instructions 
have non repeating 
forms 
MW+ 
and MW-. These instructions 
perform 
the same move func- 
tion as their repeating 
counterparts 
except that 
only one word is 
moved per execution of the instruction. 
HL and DE are incremented 
or decremented 
and BC is decremented. 
MW+ 
and MW- turn the 
overflow bit on, i.e. a one, if BC is nonzero after execution. 
If BC is 
zero after executing MW+ 
or MW- the overflow bit is cleared, i.e., 


made zero. 
The transfer 
of data by MW+, 
MW+R, 
MW-, or MW-R does not 
involve the Z80's A register. A constant may be held in A during the 
transfer. 
An interesting application 
of the Z80 block move instructions 
is to 
data structures 
known as stacks. One type of stack behaves some- 
thing like a section of railroad 
track which has room for some exact 
number of cars. If a car is pushed into one end of the stack another 


car is pushed out of the other end. This kind of structure is known as 
a FIFO stack, meaning First In First Out. Such a stack can be used to 
hold a "model" 
of a piece of track. An application 
of this is shown 
in example 6-9. 


A section of railroad track is to be modeled in the comput- 
er. This section of track will hold exactly 36 cars. Each of 
the 36 positions in the model of the track section is to hold 
the identifying 
number of the car in that relative position 
on the track. 
A new car is "pushed" 
into the model by 
moving the entire block of identifiers up to make room for 
the new one. This forces the oldest identifier out the top. 
Beginning with the new identifier in the A register, enter it 
into the block and finish with the identifier which has been 
pushed out in A. 


This brings us to the necessity of knowing how to make the 
assembler reserve a block of memory. 
This is done by the 
RES and BSS pseudo-ops. 
RES, meaning 
REServe, 
and 
BSS, meaning 
~lock 
Started 
by Symbol, 
are different 
ways of saying the same thing. They both direct the assem- 
bler to assign a block of memory whose length is given in 
the operand 
of the RES or BSS. A block of 36 locations 
can be reserved under the name TRACK by: 


The symbol TRACK 
refers 
to the first locations 
of the 
block, Le., the one with the lowest memory address. 
The 
last location 
of the block is TRACK + 35. RES and BSS 
will accept a second operand, 
if desired. If the second op- 


erand is given, it is taken to mean the value with which the 
block is to be filled, e.g.: 


will result in the entire block being filled with 111111012 
when the program 
is loaded for execution, while: 


will fill the block with 110001112, 
the ASCII code for the 
letter G. 


There are several ways to solve the problem 
posed in this 
example. One would be to save the last word, the one to be 
pushed out, then move the block, then insert the new word 
into the lowest block address, 
TRACK. 
This operation 
looks like this: 


ins!. 
STA 
LXI 


LXI 
LXI 
LDA 


operand 
NEW 
B,35 


D;I'RACK+35 
H;I'RACK+34 
TRACK +35 


STA 
OLD 
MW-R 
LDA 
NEW 
STA 
TRACK 
LDA 
OLD 


save new value 
move count to B. Note 
that though there are 36 
words in the block there 
will be only 35 moves 
"to" 
address to DE 
"from" 
address to HL 
save old value to be 
pushed out 


move the block up 
retrieve new value 
place at bottom of stack 
and retrieve the 
"pushed 
out" value 
program 
continues 


NEW and OLD are presumed 
here to have been defined 
elsewhere 
in 
the program. 
This will work, 
but is somewhat 
clumsy, 
and there is a 
better 
way. 
Suppose 
the locations 
NEW and OLD in example 
6-9 
had been defined to be part of a block named TRACK, like this: 


NEW 
*** 
TRACK 
RES 
36 
OLD 
*** 


The problem 
then becomes 
one of managing 
a 38 word block begin- 
ning with NEW and ending with OLD. The new entry is simply plac- 
ed in NEW and the entire block including 
NEW and OLD is moved. 


This makes the solution 
to the problem 
shorter, 
as shown in example 
6-10. 


Using the method 
just described, 
solve the problem 
posed 
in example 6-9. 


label 
inst. 
operand 
STA 
NEW 
save new value. This 
places NEW immedi- 
ately below the first 
word of TRACK 
LXI 
B,37 
the count is now 
37 because the block 
has increased 
in size 
to 38- 


LXI 
D,OLD 
address 
of the last word 
of the 38 word block as 
"to" 
address 
in DE 
LXI 
H;I'RACK+35 
address 
of last word 
of TRACK as "from" 
address 
MW-R 
move the block 
LDA 
OLD 
get the value pushed out 


Examples 6-9 and 6-10 illustrate something important 
about the 
programming craft in general, namely, that there is no single correct 
solution to most problems. There are a variety of methods by which 
most problems can be solved and the method of attack will vary with 
the situation. Quite often the solution of a problem involves a trade 
of memory space for speed of execution or vice versa. Since relative- 
ly few computer applications demand great speed the usual practice 
is to write programs in such a way as to conserve memory use. While 
memory is not as expensive as it was even a short time ago, it is still 
usually the most costly single item in the computer. For programs 
which will run in a large development system this makes no differ- 
ence, but if the computer is being used as a controller in a manufac- 
tured item the extra memory burden caused by sloppy programming 
practices represents an extra fixed cost in every copy of the manufac- 
tured item. The emphasis in this book will therefore usually be on 
economy of memory use. 


7 I ARITHMETIC AND lOGICAl 
OPERATIONS ON THEzao 


"D'ye think th' colledges has much to do with th' progress iv th' 
wurruld?" asked Mr. Hennessy. "D'ye think:' said Mr. Dooley, '''tis 
th' mill that makes the wather run?" 


Mr. Dooley's Opinions 
Finley Peter Dunne 


The principal arithmetic 
register of the Z80, and the only register 
in which logical operations 
can be performed 
is the A register. Some 
limited 16 bit arithmetic 
can be performed 
in register pairs, but other 
than this all arithmetic 
and logical operations 
are performed 
either 
between A and another 
8 bit register or between A and a memory 
word pointed to by a register pointer. 
Addition, 
subtraction 
and the logical operations 
result in the bits 
of the F register being set to reflect the type of result generated by the 
operation. 
The bits and their meanings are: 


S - 
Sign flag. This flag is a copy of the highest bit (sign bit) 
of the accumulator. 
It is set to one if the result was nega- 
tive and zero if the result was positive. The state of the S 
bit can be tested and program 
flow altered 
by the JP, 
jump if plus, and JM, jump if minus, instructions. 
Two 
things should be noted here. First, a zero result is consid- 
ered to be positive, and second, there are no branch (rela- 
tive jump) 
instructions 
capable 
of testing for plus and 
minus. The longer jump form must therefore be used. 


Z 
- Zero flag. This flag is set to one if the result was a zero 
and to zero if the result was nonzero. 
If this inversion 
seems confusing, 
it need not worry you. The jump and 
branch instruction 
test the proper sense of the result, i.e., 
HZ and JZ transfer 
control 
if the result was zero and 


BNZ and JNZ transfer control if the result was nonzero. 
The programmer rarely has to deal with the Z flag itself. 


A - 
Auxiliary carry flag. This bit detects the occurrence of a 
carry or borrow between the low four bits of A and the 
high four bits during an add or subtract operation. 
It 
cannot be tested by jump or branch instructions. 
It is 
used by the DAA instruction to rectify the sum or differ- 
ence of BCD numbers. This operation will be covered in 
chapter 11. 


v - 
Overflow/Parity 
flag. This flag is set to one if the re- 
sult of an addition or subtraction is too large to be held in 
the allotted space. It is also used as an indicator for cer- 
tain other 
conditions, 
e.g., that 
the execution 
of an 
MW+, 
MW·, CP+, 
or CP- instruction 
has caused the 
count in the BC to become zero. It is used also to indicate 
the evenness or oddness of the number of one bits in a 
result. It can be tested by the JV, JNV, JPE and JPO 
instructions. 


N - 
Add/Subtract 
flag. 
This flag is set to zero by add 
instructions and to one by subtract instructions. It is used 
by the DAA instruction in conjunction with auxiliary car- 
ry to adjust sums or differences of BCD numbers. It can- 
not be tested by jump or branch instructions. 


C - 
Carry flag. This bit is set to one if the addition of two 
numbers, considered as unsigned magnitudes, results in a 
carry out of the high bit of the sum. It is also set to one 
if, in the subtraction of two unsigned quantities, the sub- 
trahend is greater than the minuend. The carry bit thus 
functions 
as a one bit extension of the generated sum 
or difference. It is tested by the JC, JNC, BC and BNC 
instructions. 


Simple addition to the A register is done in the Z80 by the ADD in- 
struction. Addition of another register is done by specifying the reg- 
ister as the operand, i.e.: 


adds the contents of the E register to those of A, leaving the sum in 
A and the flags set as described above. Addition of the contents of a 
memory word through a pointer held in HL is done by: 


If the pointer is held in X or Y the form is slightly different. 
The 
pointer register identification is part of the mnemonic and the oper- 
and specifies the displacement, as for the load and store through X 
or Y described in chapter 6. Addition through X is done by: 


As with the loads and stores, the displacement need not be zero but 
may specify any value from + 127 through -128. This use of the dis- 
placement is shown in example 7-1. 


A three word block of numbers is in memory beginning at 
location TRIO. Using a pointer held in X, find the sum of 
the three numbers. 


inst. 
LXI 
operand 
X,TRIO 
address of first word 
ofTRIOtoX. 
X now points to the 
word with the lowest 
memory address 
load first word into A 
through X 


ADDX 
1 
ADDX 
2 
add second word 
add third word 


Very few real world problems can be solved, however, with addi- 
tion which is limited to eight bits. For this reason the Z80 contains 
facilities for the performance 
of arithmetic on numbers which are 
more than one word long. Such arithmetic is known as multiple pre- 
cision arithmetic, the case in which the number is two words long be- 
ing known as double precision arithmetic. We will cover the double 
precision case here. If double precision is understood 
there is no 
problem in extending it to cover arithmetic of any required length. 


Consider the following double precision binary numbers: 


00000000 
000000112 = + 310 
11111111 
111111112= 
-110 


the left or most significant part of these numbers is known as the 
high order, the least significant part being known as the low order. 
Both numbers fit the requirement that nonsignificant 
leading digits 
are filled with copies of the sign bit. The addition of these numbers 
begins with the addition of the low order parts, i.e.: 


00000011 
+ 
11111111 


1 00000010 


low order augend 
low order addend 


low order sum 


this result being the low order sum. The detached one at the left of 
the low order sum represents the carry which occurred out of the 
leftmost bit of the sum. The high order sum is formed by adding the 
high order addend and augend, and the carry from 
the low order, 
i.e.: 


00000000 
+ 
11111111 
+ 
1 


1 00000000 


high order augend 
high order addend 
carry from low order 
high order sum 


The final sum is 00000000 
000000102= 210• Again, the detached 
one at the left is the carry out of the leftmost bit of the sum. If the 
addition were to be done in length greater than double this carry 
would be added to the third order, the carry from the third order 
added to the fourth and so on. 
The normal ADD instruction of the Z80 ignores the previous state 
of carry. If the ADC instruction is used, however, the previous carry 
is added along with the addend to the augend. In this way carries 
from lower orders can be propagated to higher orders of a multiple 
precision sum. Addition with carry of another eight bit register is 
done, e.g.: 


which adds the contents of the D register plus previous carry to A. 
Addition of a memory word to A through a pointer held in HL is 
done by: 


the small d's representing the displacements of the indexed instruc- 
tions. A double precision addition is shown in example 7-2. 


A pair of double precision numbers is Be and DE. Find 
the sum of the numbers, leaving this result in DE. 


MOV 
A,E 
low augend to A 
ADD 
C 
form low sum 
MOV 
E,A 
save low order sum 
MOV 
A,D 
high augend to A 
ADC 
B 
add high orders plus 
carry from low order to 
form high sum 
MOV 
D,A 
save high sum in D 


Double precision addition of numbers in memory is illustrated in 
example 7-3. 


Double precision numbers are in memory locations named 
LUKE and KENOBI. Find the double precision sum and 
leave it in memory at TARKIN. 


label 
inst. 
operand 
LXI 
B,LUKE 
address of LUKE to Be 
LXI 
H,KENOBI 
address of KENOBI 
toHL 
LXI 
D,TARKIN 
address of TARKIN 
to DE 
LDAX 
B 
low order LUKE to A 
ADD 
M 
add low order KENOBI 
STAX 
D 
save low order sum in 
TARKIN 
INX 
B 
increment LUKE 
pointer 
INX 
H 
increment KENOBI 
pointer 
INX 
D 
increment TARKIN 


pointer 
high order LUKE to A 
form high order sum 
including carry from 
low order 
save high order sum in 
TARKIN+l 


LDAX 
B 
ADC 
M 


Subtraction 
is accomplished in a similar way. Carry in this case 
acts as a borrow, the borrow being propagated to the higher order. 
Simple subtraction is done by the SUB instruction, while subtraction 
including previous borrow is done by the SBB instruction. A double 
precision subtraction is shown in example 7-4. 


In a numerical differencing problem a pair of double pre- 
cision numbers is left in the four memory words which be- 
gin at location N. Find the difference of these two num- 
bers, subtracting the one with the higher memory address 
from the one with the lower memory address. Leave the 
difference in DIFF. 


label 
inst. 
operand 
LXI 
D,N 
address of lower 
number to DE 
LXI 
H,N+2 
address of higher 
number to HL 
LDAX 
D 
get low order minuend 
SUB 
M 
form low order 
difference 
STA 
DIFF 
save low order 
difference 
INX 
D 
increment minuend 


pointer 
increment 
subtrahend 
pointer 
get high minuend 
form high order 
difference 
save high order 
difference 


LDAX 
D 
SOB 
M 


Before 
leaving 
examples 
7-2, 7-3 and 7-4, it should 
be noted 
that 
though 
these 
examples 
required 
no test 
for 
overflow, 
the proper 
place for such a test is immediately 
after the high order 
sum or dif- 
ference is formed. 
Overflow 
of any of the low order sums or differ- 
ences is meaningless. 
Like the data movement 
instructions 
of the last chapter 
the arith- 
metic instructions 
have immediate 
counterparts, 
forms 
which con- 
tain the constant 
to be added as part of the instruction. 
These are: 


ADI 
n 
add immediate 
ACI 
n 
add immediate 
plus 
previous 
carry 
SUI 
n 
subtract 
immediate 
SOl 
n 
subtract 
with borrow 
immediate 


The n operands 
of the above instructions 
denote 
the eight bit imme- 
diate data to be added 
or subtracted. 
These operands 
may be of any 
form so long as the value can be contained 
in eight bits. Some of the 
possible 
variations 
are shown below. 


ADI 
SUI 
SOl 
ACI 


3 
@77 
:3F 
'H' 


decimal constant 
octal constant 
hexadecimal 
constant 
ASCII character 
constant 


Memory locations HAROLD and HAROLD+l 
contain a 
double precision number. Use the immediate add instruc- 
tions to add the constant 5710 to it. 


label 
inst. 
operand 
LDA 
HAROLD 
low order HAROLD 
toA 
ADI 
57 
add constant 57 to 
low order 
STA 
HAROLD 
save new low order 
LDA 
HAROLD +1 high order HAROLD 
toA 
ACI 
0 
propagate carry to 
high order 
STA 
HAROLD +1 save new high order 


It is most important 
that the reader understand 
what went on in 
example 7-5. If you didn't follow it then you don't understand 
the 
propagation of carry and much of the remainder of this book will be 
a mystery. The idea of the ACI with a zero operand is simply to pro- 
pagate any carry which may have been generated by the ADI. The 
STA and LDA which follow the ADI do not alter any of the flags. 
When ACI is executed the state of carry is the same as when the ADI 
instructions finished. Again, do not leave this example until you un- 
derstand it. 
Double precision addition and subtraction 
can also be done be- 
tween the HL and another register pair by means of the DAD, DAC 
and DSC instructions. The operands of these instructions specify the 
addend register pair, e.g.: 


DAD 
DAC 
addBCtoHL 
AddDEtoHL, 
including previous 


carry 
subtract Be from HL, 
including previous 
borrow 
add the contents of the 
16bit stack pointer 
register to HL. More 
will be said of SP later. 


DAD is an 8080 instruction, 
while DAC and DSC are unique to the 
Z80. DAD performs addition which ignores previous carry and sets 
only the carry bit of the flag word, all the other flags being left un- 
changed. DAC and DSC include previous carry/borrow 
and do set 
the flags in a meaningful way. Note that it is possible to check for 
arithmetic overflow after DAC and DSC but not after DAD. The use 
of these double precision instructions is shown in example 7-6. 


A pair of quadruple 
precision numbers is located at Nl 
and N2. Find their sum and leave it at Ql. If overflow oc- 
curs, transfer control to location TILT. 


label 
ins!. 
operand 


LHLD 
Nl 
low augend to HL 
LDED 
N2 
low addend to DE 
DAD 
D 
form low order sum 
SHLD 
Ql 
save low sum 
LHLD 
Nl+2 
get high order augend 
LDED 
N2+2 
and high order addend 
DAC 
D 
form high sum 
including carry from 
low order 
SHLD 
Ql+2 
save high order sum 
JV 
TILT 
test for overflow 


The two instructions, DAD and DAC, perform 16 bit addition 
without and with carry, respectively. For subtraction, 
however, 
there is only the DSC instruction which always includes previous 
borrow. To accomplish multilength subtraction, therefore, the car- 
ry/borrow must be set to zero before the lowest order subtraction is 
done. This is shown in example 7-7. 


Double precision numbers are located in the HL and DE 
register pairs. Find the difference DE-HL, leaving it in 
HL. Notice that the HL contents must be subtracted from 
the DE contents. This cannot be done directly, so the num- 
bers must be swapped. This is done with the XCHG in- 
struction which swaps the contents of DE with those of 
HL. 


ins!. 
XCHG 
this swaps the contents 
of the DE and HL 
register pairs 
I 
this sets the carry bit 
to zero. RSC is not an 
8080or Z80 instruction 
as such, but a synonym 
for another instruction 
which has no effect 
other than to set 
the flags (ORA 
A) 
form the difference 


Until now we have treated all numbers on the Z80 as if they were 
integers. An integer is simply a number in which the point is implied 
to be all the way at the right hand end of the number. This need not 
be so, as the hardware performs only arithmetic and is indifferent to 
any arbitrary placement of a point by the programmer. Because 


many 
applications 
require 
the representation 
and manipulation 
of 
fractions 
we will now explore this subject. 


The integer portion 
of a number 
is represented 
as the sum of a se- 
ries of positive powers of two which increases 
to the left. If we decid- 
ed to locate 
the point 
in the middle 
of the Z80 word 
the decimal 
number 
11 would look like this: 


A fraction 
is represented 
by a series of negative 
powers 
of two going 
toward 
the right. 
The leftmost 
fraction 
bit corresponds 
to the 2-1 or 
halves position, 
the next one to the 2-2 or quarters 
position. 
In this 
scheme the decimal 
number 
11.25 would be represented: 


The integer 
is interpreted 
exactly as before. 
The fraction 
consists 
of 
a zero in the halves bit, a one in the quarters 
bit and zeros elsewhere. 
The total value of the fraction 
is therefore 
~. The number 
of bits re- 
served for fraction, 
in the above case 4, is known 
as the scale factor. 
Numbers 
with identical 
scale factors 
may be added or subtracted 
just 
as integers are, e.g.: 


1011.01002 
+ 0001.11002 


1101.00002 


= 11.2510 
= 1.7510 


= 13.010 


If the numbers 
in the addition 
above were to be considered 
as pure 
integers, 
with the point located 
all the way to the right, 
their values 
would be 180 (11.25) and 28 (1.75) and their sum would be 208. If the 
point in the sum just derived is ignored 
and the resulting 
integer con- 
verted to decimal, 
its value is 208. The addition 
process iteslf is indif- 
ferent to the placement 
of the point. 


If the scale factors 
of numbers 
to be added 
or subtracted 
are dif- 
ferent 
we have a problem. 
Before 
the addition 
or subtraction 
can 
take place the scale factors 
must be equalized 
by shifting 
one or the 
other of the numbers. 
Consider 
the numbers: 


000001.0b 
00011.1002 
1.25, scale factor 2 
3.5, scale factor 3 


These two numbers cannot be added directly because of the differ- 
ence in their scale factors. The upper number could be shifted left to 
give: 


In this case either scaling would work to allow the numbers to be 
added or subtracted, but let's go back to the number with which we 
started 
the 
fraction 
exercise, 
1011.0100 and 
attempt 
to 
add 
001.10001, like this: 


1011.0100 
+ 001.10001 
11.25, scale factor 4 
1.53125, scale factor 5 


Now we have a problem. If we shift the lower number to the right the 
lowest bit will be lost and the value of the number will become 1.5 in- 
stead of 1.53125. If we shift the upper number to the left, however, 
we are in a worse situation. The highest bit is shifted out and lost, the 
result being: 


or 3.25 scale factor 5. Where the loss of the 1/32s bit in the right 
shift above involved a loss of precision, this left shift is a total 
disaster which destroys the value of the number. 
This type of arithmetic in which the programmer 
chooses a loca- 
tion for the point and then shifts to equalize scale factors is known as 
fixed point arithmetic. If a problem can be solved using fixed point 
arithmetic there are significant advantages in both space and speed 
to be gained. Where this is not possible or where the range of inter- 
mediate results cannot be predicted it is necessary to use a system of 
arithmetic 
in which the scale factor 
is kept automatically. 
This 


scheme is known as floating point arithmetic and will be covered in 
depth in a later chapter. 
The shifting required for scaling and other purposes in the Z80 is 
accomplished by three distinct types of shift instructions. These are: 


a) 
Rotary shifts in which the bit shifted out reenters the register 
from the opposite end, either directly or through the carry bit; 


b) 
Logical shifts in which the vacated position is filled with zero 
and the bit shifted out enters carry; 


c) 
Arithmetic shifts in which only the rightmost 7 bits participate 
in the shift, the sign remaining fixed. 


The Z80 has two types of rotary shift. In the first type the bit shift- 


ed out reenters the other end of the register immediately and is also 
copied into the carry bit. The basic mnemonics for these shifts are 
RRC and RLC for right and left shifts, respectively. If no register 
name is attached to the mnemonic the A register is shifted. If a regis- 
ter name is attached, e.g., RRCE, then the named register is the one 
shifted. The effect of an RRC is shown below. 


carry 


x 
1 


register 
01110001 
10111000 


The entire register has been rotated right, the former low bit now be- 
coming the high bit as well as being copied into carry. The former 
contents of carry are irrelevant and are lost. The effect of an RLC is: 


carry 
x 
o 


register 
01110001 
11100010 
before 
after 


The register contents have been rotated left, the former high bit be- 
ing copied into the low bit and also carry. 
Any of the register names A, B, C, D, E, H or L may be appended 
to the RRC and RLC mnemonics to perform shifts in those registers. 
Words in computer memory may be shifted in the same way by spe- 


cifying a pointer. The mnemonic form RRCM or RLCM shifts the 
memory word pointed to by HL. The forms RRCX, RRCY, RLCX 
and RLCY specify the shifting of a memory word pointed to by X or 
Y. Note that in this last case the operand must specify a displace- 
ment, as for any indexed instruction, i.e.: 


The second type of rotary shift uses the carry bit as a ninth partici- 
pating bit. The bit shifted out of the register enters carry and the for- 
mer contents of carry enter the opposite end of the word. This is use- 
ful in multiple length shifts as we shall presently see. The form of the 
mnemonics for these shifts is RrR and RrL for the right and left 
shifts respectively, the small r in the form denoting the name of an 
eight bit register as specified for RRC and RLC above. The effect of 
RDR on the D register and carry is shown below: 


carry 
1 
o 


D register 
01110010 
10111001 
before 
after 


Note that the rotation takes place through the carry bit. The former 
contents of carry are not irrelevent. The effect of an RHL on the H 
register and carry is shown below. 


carry 
o 
1 


Hregister 
10101010 
01010100 
before 
after 


Before leaving these nine bit rotary shifts, note must be made of 
their effect on the flags. RAR and RAL are 8080 instructions which 
rotate the A register and carry, with only A and carry being changed. 
Both are one word instructions. The Z80 contains two word forms of 
these instructions 
which perform the same functions as RAR and 
RAL but set the sign and zero flags as well as carry. If the two word 
Z80 form is required, a dollar sign is attached to the mnemonic, i.e., 
it reads RAR$ or RAL$. This applies only to A register rotates. 
In summary, the rotary shifts are of two types. The first type, 
RRC and RLC, rotates the word as an eight bit unit, the bit shifted 


out entering the other end of the word immediately and being copied 
simultaneously into the carry bit. The former contents of carry are 
irrelevant and are lost. Eight successive shifts in the same direction 
restores the original A register, but not carry. In the second type, 
RrR and RrL, the carry bit and register are rotated as a nine bit unit, 
the former contents of carry entering the vacated position and the bit 
shifted out entering carry. Nine successive shifts in the same direc- 
tion restores both the register and carry to their original condition. 
Logical shifts are similar to rotary shifts except that the vacated 
position is always filled with zero. The effect of a logical shift can be 
achieved with a nine bit rotary shift if the carry bit is set to zero be- 
fore shifting. Mnemonics for the logical shifts are LLr and LRr for 
left and right shifts, respectively, the small r denoting the name of an 
eight bit register. If a memory word is to be shifted it must be done 
through a pointer. To shift the memory word pointed to by HL: 


LLM 
or 
LRM 


If the pointer is held in X or Y the mnemonics become LRMX, 
LRMY, LLMX and LLMY, with the displacement being specified in 
the operand as for all other operations through X and Y,e.g.: 


performs a logical left shift of the memory word one higher than 
that pointed to by X, while: 


right shifts the word two below the one pointed to by Y. 


The effect of a logical right shift is shown below. 


carry register/memory 
x 
11111111 
before 
1 
01111111 
after 


The previous 
contents 
of carry are irrelevant 
and are lost. The effect 
of a logical left shift is: 


carry register/memory 
x 
11111111 
before 
1 
11111110 
after 


The arithmetic 
effect 
of logical 
shifts 
is to multiply 
or divide 
by 
two, 
multiplication 
for left shifts 
and division 
for right 
shifts. 
For 
left shifts the multiplication 
is exact provided 
no significant 
bits are 
shifted 
out. For right shifts the effect is to divide by two, discarding 
any remainder. 
Consider 
the following 
right shift. 


after one right shift: 
after two right shifts: 
after three right shifts: 
after four right shifts: 
after five right shifts: 


carry 
x 
1 
o 
1 
o 
1 


register/memory 
00010101 
00001010 
00000101 
00000010 
00000001 
00000000 


decimal 
2Lo 
1010 
510 
210 
Lo 
010 


In each case the result 
is the same as if division 
by two had taken 
place with the remainder 
discarded. 
The final type of shift 
is known 
as an arithmetic 
shift. 
In these 
shifts the sign bit is treated 
as a special case. In the case of a left shift 
bits shifted 
out of the highest 
magnitude 
bit do not enter the sign. 
While the Z80 does not have an arithmetic 
left shift instruction, 
the 
left shift function 
will be shown here for completeness. 


11001001 
10010010 
before, 
after, 
- 5510 
-11010 


The effect here is the same as that of a logical shift, namely to multi- 
ply the number 
by two. If the arithmetic 
left shift is performed 
again 
we have: 


a wrong result. This is because a significant bit, the zero immediately 
to the right of the sign, has been lost. 


Arithmetic 
right shift is accomplished 
in the Z80 by the ARr in- 
struction, 
the small r denoting the name of an eight bit register. In an 
arithmetic 
right shift only the rightmost 
seven bits of the number are 
shifted, with the vacated high magnitude 
bit being filled with a copy 
of the sign bit. For positive numbers 
this is identical 
to a logical 
shift. If the number is negative the vacated bit becomes a one, how- 
ever. An arithmetic 
right shift of a negative number is shown below. 


after one shift: 
after two shifts: 
after three shifts: 
after four shifts: 


carry 
x 
1 
1 
o 
1 


register/memory 
11111011 
-510 
11111101 
-310 
11111110 
-210 
11111111 
-110 
11111111 
-110, the same thing! 


This produces 
a result that is rather different 
from a logical shift. 
The results of the successive shifts do not simply discard the remain- 
der but round down to the next more negative integer. No matter 
how many arithmetic 
right shifts follow the result will remain 
the 
same, minus one. 


A multilength 
arithmetic right shift is shown in example 7-8. 


The double precision signed number at location POPEYE 
is to be divided by 2 by shifting. 
The Z80's registers are 
not available so the shift must be done through 
a pointer 
held inX. 


This problem requires a double right shift. The high order 
part is shifted first, the bit shifted out being held in carty. 
The bit in carry is then rotated into the high bit of the low 
order word using a rotate which includes carry as a ninth 
bit. 


ins!. 
LXI 
operand 
X,POPEYE 
address of the low order 
word of POP EYE to X 
1 
arithmetic shift high 
order. Recall that the 
high order occupies the 
word with memory ad- 
dress one greater than 
the low order. The dis- 
placement of 1 forces 
this word to be ad- 
dressed. The bit shifted 
out is now in carry 
o 
rotate the bit shifted out 
of the high order into 
the high bit of the low 
order word 


A double length left shift involves a similar process. This time the 
low order is shifted first, the bit shifted out again being held tempo- 
rarily in carry. This bit is then shifted into the low position of the 
high order word with a rotary shift. In performing this type of shift 
it is the programmer's 
responsibility to insure that no overflow oc- 
curs, Le., that no significant bit is shifted out of the high order. The 
Z80 cannot detect this automatically and the loss of a high order bit 
is usually a catastrophe. 
If the number is an unsigned magnitude the 
overflow can be detected by testing for carry after the high order is 
shifted left. For signed numbers a test must be made to see whether 
the shift has altered the algebraic sign. If the sign has changed the 
shift is invalid. Some microcomputers 
like the M6800 detect this 
condition in hardware by sensing the logical difference (Exclusive 
OR) of the bits shifted into and out of the sign bit during all left 
shifts. The signed case is shown in example 7-9. 


A signed double precision number, i.e., a sign bit and 15 
magnitude 
bits, is in the Be register pair. Perform 
an 
arithmetic left shift of this number. If an overflow occurs 
send control to location DSASTR. 


The shift itself is simple enough, logical shift the low order 
word, then "roll" 
the bit shifted out of the low order word 
into the low position of the high order word with a nine bit 
rotate left instruction. The detection of the change in sign 
is the main problem here. To do this a copy of the original 
high order is kept and the signs of the unshifted and shift- 
ed high orders are compared. If the signs are different an 
overflow has occurred. The comparison of the two signs is 
best done by Exclusive ORing them together. 
This in- 
volves use of an instruction not yet discussed, XRA. The 
effect of XRA is to Exclusive OR the two quantities, set- 
ting the F register flags to show the character of the result. 
If the two signs were different the result of Exclusive OR- 
ing them will be negative. The overflow test can therefore 
be done with a JM instruction. 
The solution to the prob- 
lem is: 


ins!. 
MOV 
operand 
A,B 
save a copy of the high 
order in A register 
logical shift low order 
left 
shift high order, bring 
in bit from low order 
form Exclusive OR 
of new and old high 
orders. If the sign flag 
is set an overflow 
occurred. 
test for overflow 


If the double precision quantity to be left shifted is an unsigned 
magnitude the detection of overflow is somewhat different. Since a 
significant bit is in this case a one, the overflow can be detected by 
testing carry. Carry will contain the bit shifted out. If it is a one an 
overflow has occurred. This shift is shown in example 7-10. 


An unsigned 16bit number is in the HL registers. Shift this 
number left and transfer control to DSASTR if an over- 
flow occurs. 


label 
inst. 
operand 
LLL 
shift low order left 
RHL 
shift high order, "roll 
in" bit from low order 
BC 
DSASTR 
test for a one in carry 


Logical operations can be performed in the Z80 only in the A reg- 
ister. The mnemonics for Inclusive OR, AND and Exclusive OR are 
ORA, ANA and XRA respectively, the trailing A in each mnemonic 
being redundant since no register other than A can be used. The op- 
erands for these mnemonics are either the name of an eight bit regis- 
ter or a pointer specification, e.g.: 


ORA 
L 
OR contents of A 
with L 
ANA 
B 
AND contents of A 
with B 
XRA 
C 
Exclusive OR contents 
of A with C 


In each case the result is left in the A register and the other register is 
undisturbed. 
To perform logical operations between A and a memo- 
ry word whose address is in HL: 


ORA 
M 
ANA 
M 
XRA 
M 


ORX 
ANX 
XRX 


ORY 
0 
ANY 
0 
XRY 
0 


An application of the Inclusive OR instruction is shown in exam- 
ple 7-11. 


A block of five memory locations beginning at COUNTS 
is being used to accumulate counts of the frequency with 
which incoming data falls into various ranges. Scan the 
five word block to determine whether any of the counts 
has become nonzero. If they are all zero transfer control 
to location BACK. If any or all of the counts are nonzero 
transfer control to BINGO. 


label 
inst. 
operand 
LXI 
X,COUNTS 
address of first word of 
block to X 
ZAR 
clear the A register. 
ZAR is not really an in- 
struction, but a syno- 
nym for another in- 
struction, XRA 
A. 
which Exclusive ORs A 
with itself to produce a 
zero A register 
ORX 
0 
OR first member 
ORX 
1 
second ... 
ORX 
2 
third ... 


BZ 
BRA 
BACK 
BINGO 


fourth ... 
and fifth. If all five 
words were zero the A 
register is zero and the 
Z flag will indicate this 
go to BACK if all zeros 
or to BIN GO if one or 
more is nonzero 


ORX 
ORX 


The AND function can be used to scan a block in a different way. 
This is shown in example 7-12. 


The five word block which beings at CNTGRD 
contains 
the temperatures at various points in a food freezing oper- 
ation. Scan the block and transfer control to ALARM 
if 
any of the temperatures is positive, Le., at or above freez- 
ing on the centigrade scale. If all of the temperatures 
are 
negative the sign bits of the five words will all be ones. 
ANDing the five words together should produce a result 
with a one in the sign bit in this case. If one or more of the 
temperatures is positive or zero this result will have a zero 
in the sign bit. 


label 
ins!. 
operand 
LXI 
X,CNTGRD 
address of temperature 
block to X 
LAX 
0 
first temperature to A 
through X 
ANX 
1 
AND the other four 
with the first 
ANX 
2 


ANX 
ANX 
JP 


3 
4 
ALARM 
if any of the 
temperatures 
was zero 
or positive the result 
will be positive 


The Exclusive 
OR function 
is often used for a kind of comparison, 
e.g., the determination 
of the algebraic 
sign of a product 
or quotient 
without 
actually 
doing the multiplication 
or division. 
Another 
appli- 
cation for this kind of bit comparison 
is shown in example 7-13. 


The trigonometric 
sine of an angle is in the B register, 
the 
cosine of the same angle being in the D register. 
Determine 
quadrant 
in which the angle lies, leaving the result in the H 
register. 


The sine of an angle 
is positive 
in the first 
and 
second 
quadrants 
and negative 
in the third and fourth, 
while the 
cosine 
is positive 
in the first 
and 
fourth 
quadrants 
and 
negative 
in the second and third. 
The algebraic 
signs of the 
functions 
in Band 
D are used to determine 
the quadrant. 


operand 


H,O 
A,B 
D 


MVI 
MOV 
XRA 


clear H to receive result 
bring sine into A 
this produces 
the logical 
difference 
of the alge- 
braic signs of the sine 
and cosine in the sign 
bit of A. If this is zero 


the angle must lie in the 
first or third quadrant. 
If the sign bit of A is a 
one the angle falls in 
the second or fourth 
quadrant 
RAL 
now rotate the sign bit 
out of A 
RHL 
and into the low bit of 
H. The H register now 
contains zero or one 
MOV 
A,B 
get the sine again 
ORA 
A 
this has no effect on A. 
It merely sets the flags 
so that the algebraic 
sign can be tested 
JP 
QUAD2 
if the sine was positive 
there is nothing more to 
be done except to incre- 
ment the quadrant 
number to read one or 
two instead of zero 
or one 
INR 
H 
if the s~newas negative 
the quadrant number 
must be incremented 
twice as the angle lies in 
the third or fourth 
quadrant 
INR 
H 
QUAD2 
INR 
H 
this final INR 
increments the 
quadrant number to the 
one through four range 


Like the load and arithmetic instructions, 
the logical instructions 
have immediate forms in which the operand is part of the instruc- 
tion. These forms are ORI, ANI and XRI for OR, AND and Exclu- 
sive OR, respectively. The immediate operand may be of any form 
which generates a legitimate eight bit number, e.g.: 


ORI 
'0' 
ASCII operand 
ANI:F 
hexadecimal operand 
XRI 
@66 
octal operand 
ANI 
ORPHAN 
symbolic operand. 
ORPHAN would, in 
this case, be defined by 
anEQU like 
ORPHAN 
EQU 
:CO. 
XRI 
FIRST-SECOND 
sum or difference of 
symbols 


In all of these cases the operand must fit into eight bits. If the oper- 
and length is greater than eight bits the instruction will be flagged by 
the assembler with an L, for length error. 


The final topics of this chapter are the comparison and negation 
operations. 
Comparison 
is performed on the Z80 by the CMP and 
CPI instructions. 
Like the logical instructions, 
comparison 
can be 
done only between the A register and some other entity, either an- 
other eight bit register or a memory word indicated by a pointer. 
Comparison 
of A to another register is done by naming the other 
register as operand of the CMP, e.g.: 


compare A to the Band L registers. Comparison of A to a memory 
word pointed to by HL is written: 


CMPY with a displacement specified as the operand. 
A comparison is performed by subtracting the contents of the 
word being compared from the contents of the A register. The dif- 
ference between a compare and a subtract is that the contents of A 
are not changed. The result of the subtraction never appears, but is 
used to set the flags of the F register. These flags can then be tested 
just as if a subtraction had actually taken place. Thus if A contained 
a 1and C contained a 2, the instruction: 


would set the flags as if the result -1 had been generated in A. Both 
carry and the sign flag would be set to -1, and the Z flag set to zero. 
The immediate form of compare, CPI, can be used to compare the 
A register to some constant value, e.g.: 


compares A to the ASCII code for the letter T, the flags being set to 
reflect the outcome of the comparison. A simple comparison is 
shown in example 7-14. 


A memory location named TMPCHR 
contains a Celsius 
temperature of a fluid in a chemical process. Compare the 
contents of TMPCHR to the contents of the memory word 
named VALUE. 
If TMPCHR 
is greater than or equal to 
VALUE transfer control to location TOOHOT, otherwise 
transfer control to location TUCOLD. 


inst. 
LXI 
operand 
H,VALUE 
address of word to 


JP 
BRA 
TOOHOT 
TUCOLD 


which TMPCHR is to 
be compared to HL 
Celsius temperature 
toA 
perform 
the 
compar- 
ison. The flags are now 
set as if VALUE 
had been subtracted 
from TMPCHR. If 
TMPCHR would have 
been greater than or 
equal to VALUE the 
result would have 
been positive 
test for positive 
otherwise go to 
TUCOLD 


The conditions of example 7-14presumed the quantities involved 
to be signed numbers. The testing jump instruction is fairly easy to 
conceptualize in this case. If the quantities being compared were 
eight bit magnitudes the test condition would have been different. 
This type of comparison is shown in example 7-15. 


The ASCII codes for the alphabet A-Z are represented by 
the 26 codes C116 to DA16• A single ASCII character is in 
location LETTER. Test the character in LETTER. If it is 
an M transfer control to location EM. If it falls earlier in 
the alphabet than M go to BEFORE and if it falls after M 
go to AFTER. 


label 
ins!. 
operand 
LDA 
LETTER 
character to be tested 
toA 
CPI 
'M' 
compare to ASCII M 
BZ 
EM 
if the Z flag is set the 
compare was identical, 
i.e., LETTER contains 
the ASCII code for M 
BNC 
AFTER 
if the "subtraction" 
did 
not set the carry bit the 
character came after M 
BRA 
BEFORE 
otherwise it must have 
come before 


This testing of the condition bits after comparison is a tedious busi- 
ness, involving as it does remembering which bit represents which 
condition. This involves an unnecessary burden on memory and the 
assembler can help. Consider the sequence in example 7-15 above, 
but rewritten this way: 


LDA 
LETTER 
CPI 
'M' 
BEQ 
EM 
branch if equal 
BGE 
AFTER 
branch if greater than 
or equal 
BRA 
BEFORE 


The assembler will process the mnemonics BEQ and BGE as syno- 
nyms for BZ and BNC. The assembler will in fact process synonyms 
for all of the relevant jump and branch combinations after compari- 
sons of either signed numbers or unsigned magnitudes. These syno- 
nyms are: 


mnemonic 
JEQorBEQ 
JNEorBNE 
JLSorBLS 
JGEorBGE 


meaning 
jump/branch 
if equal 
jump/branch 
if not equal 
jump/branch 
if A is less 
jump/branch 
if A greater 
than or equal 


assembles as 
JZorBZ 
JNZorBNZ 
JCorBC 
JNCorBNC 


JEQorBEQ 
JNEorBNE 
J< 
J>= 


jump/branch 
if equal 
jump/branch 
if not equal 
jump if A is less 
jump if A greater than 
or equal 


JZorBZ 
JNZorBNZ 
JM 
JP 


Using these synonyms the programmer 
is relieved of the nuisance 
of remembering 
which bit does what after compares. 
The equal and 
unequal tests JEQ/BEQ 
and JNE/BNE 
are the same for both signed 
and unsigned numbers. 
Note that the Z80 provides no branch equi- 
valents 
for the J< and J> 
= instructions. 
The longer jump 
form 
must be used in both of these cases. 
A very common 
requirement 
in programs 
of all types is compari- 
son between limits. One such comparison 
is shown in example 7-16. 


The ASCII representations 
for the digits 0 through 
9 are 
codes B016 through 
B916• A character 
is in the A register. 


Compare 
it to these limits, sending control to OK if it falls 
in the 0-9 range and to NG if it does not. 


label 
inst. 
operand 
CPI 
:BO 
compare to lower limit 
BLS 
NG 
if the character 
is less 
than B016 it is 
eliminated here 
CPI 
:BA 
this comparison 
is to a 


value one greater than 
the code for 9. This is 
because it is not possi- 
ble to jump or branch 
on the less than or equal 
to condition, only on 
less than or on greater 
than or equal to 
if control gets past here 
the character was in the 
0-9 range 


Comparisons 
of double precision numbers are a bit more compli- 
cated. The high order parts are compared first and, only if the high 
orders are identical, are the low orders examined. An unsigned com- 
pare of this type is shown in example 7-17. 


Unsigned double precision numbers are in the BC register 
pair and in memory location CPND. 
The numbers are to 
be compared with control going to GRTR if the BC held 
number is greater, to LESS if the number at CPND 
is 
greater and to EQUAL if the numbers are identical. 


LXI 
X,CPND 
MOV 
A,D 
CMPX 1 


CPND pointer to X 
get high order 
compare high orders. If 
and only if the high 
orders are equal are the 
low orders examined 


BEQ 
TSTLOW 
skip to low test if equal 
BGE 
GRTR 
the equal case is already 
eliminated by the BEQ 
above, so this BGE 
transfers control only if 
the BC number was 
greater 
BRA 
LESS 
all other possibilities 
eliminated 
TSTLOW 
MOV 
A,C 
high orders equal, test 
low orders 
CMPXO 
compare low orders 
BEQ 
EQUAL 
if the low orders are 
also equal the numbers 
are identical 
BGE 
GRTR 
same comparison as for 
high order 
BRA 
LESS 
BC number less than 
CPND 


The case of the signed double precision number is only slightly 
more complicated. 
The high orders, 
consisting of sign and seven 
magnitude bits, must be compared and the tests for signed numbers 
applied. If the high orders are identical the low orders are tested as 
before. The low orders of these numbers are pure magnitude, how- 
ever, and the unsigned tests must be applied. A comparison of this 
type is shown in example 7-18. 


Double precision signed numbers are in memory at loca- 
tions 
BALL 
and 
STRIKE. 
If 
BALL 
is greater 
than 
STRIKE send control to WALK. If they are equal go to 
WAIT and if STRIKE is greater than BALL go to OUT. 


label 
inst. 
operand 
LXI 
X,BALL 
LXI 
Y,STRIKE 
LAX 
1 
CMPY 1 


BEQ 
TRY LOW 


J< 
OUT 


BRA 
WALK 


TRYLOW 
LAX 
0 
CMPYO 


BEQ 
BGE 
WAIT 
WALK 


BALL pointer to X 
STRIKE pointer to Y 
fetch high order BALL 
compare high order 
STRIKE 
high orders equal, try 
low orders 
BALL less than 
STRIKE 
BALL greater than 
STRIKE 
fetch low order BALL 
compare low orders. 
From this point on the 
testing proceeds as 
before 
numbers identical 
BALL greater than 
STRIKE 
BALL less than 
STRIKE 


Negation is performed on the Z80 in single precision by means of 
the NEG instruction. 
NEG forms the two's complement of the con- 
tents of the A register. The NEG instruction requires two words and 
is equivalent to the 8080 sequence: 


one's complement the A 
register 
increment A register 


The assembler will recognize the pseudo-op TCA (two's complement 
A) and supply the CMA and INR 
A sequence. Either the Z80 NEG 
or the 8080 TCA can be used to accomplish single precision negation 


in A. If 8080 compatibility 
is to be preserved 
use TCA or the CMA - 
INR 
A sequence. 
Negation 
of a multiple 
precision 
number 
is a little more complicat- 
ed. The various 
orders 
of the number 
are one's 
complemented 
and 
the low order then incremented. 
If this incrementation 
causes a carry 
out of the low order the next higher order must also be incremented 
and so on until 
there 
are no more 
carries 
to be propagated 
or the 
highest 
order 
is reached. 
It is very important 
to check for overflow 
after 
any negation. 
If the number 
being negated 
was the maximum 
negative 
number 
in any precision 
the result 
will be the maximum 
negative 
number 
with overflow 
turned 
on. You neglect to make this 
overflow 
test at your immediate 
peril if there is any possibility 
that 
the number 
being negated 
can achieve this value. A double 
precision 
negation 
is shown in example 7-19. 


A program 
is required 
which will negate the 16 bit number 
in HL. If an overflow 
occurs control 
should go to location 
OFLO. Disturb 
nothing 
but the A register. 


label 
ins!. 
operand 
DBLNEG 
MOV 
A,L 
CMA 
MOV 
L,A 
MOV 
A,H 
CMA 
MOV 
H,A 
INR 
L 


low order to A 
one's complement 
return 
to L 
high order to A 
one's complement 
return to H 
increment 
low order. 
Here again we have no 
way to test directly for a 
carry out of the low 
order. 
Since the only 
circumstance 
in which a 
carry could occur is if 
the low order were 
111111112 before the 


INR 
JV 
H 
OFLO 


INR 
L, the equivalent 
test is a test for zero 
after the INR 
no high order increment 
if low order not zero 
increment high order 
test for overflow 
program resumes 


8 I 
SOFTWARE 
MULTIPLICATION 
AND 
DIVISION 


Multiplication is vexation, 
Division is as bad; 
The rule of three doth puzzle me, 
And practice drives me mad. 


Anonymous Elizabethan Manuscript, 
1570 


The Z80, like most microcomputers, 
has no hardware facilities for 
multiplication 
and division. The job must therefore be done by pro- 
gramming and it is the purpose of this chapter to show the reader 
how this is done in general, and some shortcuts for special cases. We 
can begin by showing one of the oldest tricks in programming. 
Take 
any number, say 6, and write it in binary: 


00110000 
+ 00001100 


00111100 
=6010 


This strange 
looking 
procedure 
has multiplied 
the original 
6 by 10 
to give 60. This scheme will work for any number 
whatever, 
so long 
as the capacity 
of the word is not exceeded. 
Understanding 
just why 
it works is at the root of understanding 
multiplication 
in general. 


Shifting 
left once multiplies 
the number 
by two. After 
saving this 
result, 
twice the original 
number, 
we shifted 
left twice more, 
for a 
total 
of three 
left shifts 
of the original 
number. 
Shifting 
left three 
times 
multiplies 
by 23 or eight. 
Adding 
this 
to the 
saved 
result 
amounts 
to adding 
twice the original 
number 
to eight times the origi- 
nal number. 
Since 8 + 2 = 10, we have multiplied 
by ten. 


To understand 
how this works, 
look at the binary 
representation 
of the number 
ten: 


If this number 
is scanned 
from right to left, the ones occur in posi- 
tions corresponding 
to those which entered 
into the sum during 
the 
shifting. 
This scheme can be broadened 
to multiply 
by any constant 
whatever. 
To multiply 
by twelve, 
for example 
consider 
the binary 
constant 
twelve, i.e.: 


There 
are ones in the 22 and 23 positions. 
The multiplication 
is ac- 
complished 
by shifting 
the number 
left twice to put its original 
right- 
most bit into the 22 position, 
saving this result, 
and then shifting 
left 
again until the original 
rightmost 
bit is in the 23 position. 
Adding 
this 
last number 
to the saved previous 
result yields twelve times the origi- 
nal number. 
Suppose 
we start with 7: 


00111000 
+ 00011100 


01010100 
= 8410 


We have multiplied by twelve simply by shifting and adding. 
A multiplication 
by a constant using a scheme like this is shown in 
example 8-1. 
' 


There are a number of ways to go about this. The simplest 
is to follow 
the strategy 
outlined 
above. 
Writing 
15 in 
binary: 


shows it to be simply the sum of the first four powers of 
two. The program therefore looks like this: 


label 
ins!. 
operand 
MOV 
B,A 
save 2° value 
LLA 
shift left 
MOV 
C,A 
save 21 value 
LLA 
left again 
MOV 
D,A 
save 22 value 


left again to generate 
23 


times the original 
num- 
ber. The intermediate 
results saved in B, C, 
and D are now added 
ADD 
ADD 
ADD 


This is the most 
straightforward 
way to do the job, 
but 
there is yet another 
approach 
which is shorter. 
Multiplica- 
tion by 16 is easy, involving 
only a left shift of four places. 


Since 15 = 16-1, shifting 
left four places and then subtract- 
ing the original 
number 
would 
do the job. 
This is shown 
below. 


MOV 
LLA 
LLA 
LLA 
LLA 
SUB 


save original 
number 
now multiply 
by 16 by 
shifting 
the original 
number 
left four places 


and subtract 
the 
original 
value 


Some such scheme can be found 
to multiply 
by any constant 
and 
in programs 
which have time constraints 
they are well worth looking 
for, since this method 
is much faster than a full software 
multiply. 
The general 
case of multiplication 
is simply a generalization 
of the 
process just shown. 
The numbers 
to be multiplied 
are called the mul- 
tiplier and multiplicand, 
the result 
being known 
as the product. 
If 
multiplier 
and multiplicand 
are both eight bits in length the product 
will require 
16 bits. In general an N bit multiplier 
and an M bit multi- 
plicand 
generate 
an N +M bit product. 
The successive 
bits of the 
multiplier 
are tested and the multiplicand 
added to the product 
if the 


tested 
bit is a one. If the tested bit is a zero the addition 
is skipped. 


The product 
is then shifted to be in position 
to receive a contribution 
from the next power of two if that bit is a one in the multiplier. 
This 
process can be carried 
out from left to right or right to left. Since the 
double 
precision 
product 
must be shifted in the same direction 
as the 
multiplier 
the optimum 
way for the Z80 is from left to right, 
a dou- 
ble right shift being more complex 
than a double 
left shift. 
Double 
left shift of HL on the Z80 can be done with a DAD H instruction, 
while double 
right shift requires 
two instructions. 
A general 
8 bit by 
8 bit multiply 
is shown in example 
8-2. 


Example 
8-2 


Two eight bit unsigned 
numbers 
are in the D and E regis- 
ters. Find their product 
and leave it in HL. 


label 
inst. 
operand 
MOV 
A,D 
multiplier 
to A register 
MVI 
D,O 
clear D. This is 
necessary 
because the 
DE pair will be used to 
perform 
the double pre- 
cision addition 
of the 
multiplicand 
to the 
product 
being built in 
the HL register pair 
MVI 
B,8 
count to B register 
LXI 
H,O 
clear product 
area 
Ml 
DAD 
H 
shift product 
left 
RAL 
multiplier 
bit to carry 
BNC 
M2 
skip addition 
if 
multiplier 
bit zero 
DAD 
D 
otherwise 
add 
multiplicand 
to product 
M2 
DBNZ 
Ml 
decrement 
count and 
repeat if not yet zero. 


Multiplication 
of signed numbers may be done in a number of 
ways. The simplest of these is to force both multiplier and multipli- 
cand positive, perform the multiplication 
as shown in example 8-2, 
then make the necessary adjustment to the final product. The multi- 
plication of signed numbers is shown in example 8-3. 


Example 8-3 


A pair of signed two's complement numbers is in the D 
and E registers. Find their properly signed product, leav- 
ing this result in memory locations PROD and PROD +1. 


label 
ins/. 
operand 
MPY 
MOV 
A,D 
get multiplier 
XRA 
E 
form product sign 
STA 
SIGN 
and save it 
MOV 
A,D 
now force multiplier 
positive 
ORA 
A 
JP 
R2 
NEG 
MOV 
D,A 
and replace it 
R2 
MOV 
A,E 
get multiplicand 
ORA 
A 
and force it positive 
JP 
R3 
NEG 
MOV 
E,A 
and replace it 
R3 
MOV 
A,D 
move multiplier to A 
MVI 
D,O 
same process as 
example 8-2 
MVI 
B,8 
LXI 
H,O 
R4 
DAD 
H 
RAL 
BNC 
R5 
DAD 
D 


R5 
DBNZ 
R4 
LDA 
SIGN 
check for negative 
product 
ORA 
A 
JP 
EOMPY 
skip if positive 
MOV 
A,L 
otherwise negate 
product 
CMA 
MOV 
L,A 
MOV 
A,H 
CMA 
MOV 
H,A 
INX 
H 
EOMPY 
SHLD 
PROD 
save final product 
program 
continues 


It is worthwhile 
at this point to take a slight tangent from the sub- 
ject of multiplication 
to explore 
a matter 
of good 
programming 
practice. 
A close look at example 8-3 will show a couple of places in 
which more instructions 
were used than actually 
needed. The basic 
multiply 
loop 
of example 
8-2 was incorporated 
directly 
into 
the 
signed multiplication 
of example 8-3. First notice location 
R3, the 
MOV 
A,D instruction. 
This follows immediately 
after both num- 
bers are forced positive, D first and then E. If the work had been ar- 
ranged in the opposite order we could have arranged 
for the multipli- 
er to be in A when R2 was reached, eliminating 
the necessity for the 
MOV 
A,D instruction. 
Also look at the negation of the double pre- 
cision result which begins with MOV 
A,L. This double negation is 
a simplification 
of the procedure 
used in example 7-19, the check for 
overflow having been eliminated 
since no overflow is possible here. 
That example contained 
the restriction 
that only the A register could 
be used for the negation. 
Since there is no such restriction 
here a 
shorter method for the double negation can be used. The same func- 
tion rewritten for greater efficiency is shown in example 8-4. 


Example 8-4 


label 
ins/. 
operand 
MPY 
MOV 
A,D 
form product sign 
as before 
XRA 
E 
STA 
SIGN 
MOV 
A,E 
then force both 
ORA 
A 
numbers positive but 
this time do E first 
JP 
R2 
NEG 
MOV 
E,A 
R2 
MOV 
A,D 
then D, so that when 
ORA 
A 
this is finished, we have 
JP 
R3 
saved two instructions, 
NEG 
theMOV 
D,A which 
R3 
MVI 
D,O 
replaced the positive 
MVI 
B,8 
multiplier in D and the 
LXI 
H,O 
MOV 
A,Dwhich 
brought it back to A 
R4 
DAD 
H 
the multiplication loop 
RAL 
remains the same. 
BNC 
RS 
DAD 
D 
RS 
DBNZ 
R4 
LDA 
SIGN 
but the adjustment of 
ORA 
A 
the product sign can be 
JP 
EOMPY 
made shorter, since we 
can use DE 
MVI 
E,O 
clear E. D is already 
zero 
XCHG 
swap DE and HL. HL 
is now zero 
RSC 
clear carry, and 
DSC 
D 
subtract the product 
from zero 
EOMPY 
SHLD 
PROD 
store as before 


Even more could have been saved in example 
8-4 by employing 
a 
technique 
which will be described 
in chapter 
9. The STA 
SIGN and 
both 
the LDA 
SIGN 
and 
the ORA 
A which 
followed 
it which 
saved and retrieved 
the sign indicator 
could have been replaced 
by 
two one word 
instructions 
which 
save A and the flags and restore 
them when called for. 


Double 
precision 
multiplication 
can be accomplished 
in a number 
of ways. The simplest 
is to use the double 
addition 
and register 
ro- 
tates of the Z80 to perform 
the exact double 
precision 
parallel 
of the 
procedure 
used in example 
8-4. Multiplier 
and multiplicand 
are each 
16 bits long in this case, so room 
must be left for a 32 bit product. 


The procedure 
is shown in example 
8-5. A new instruction 
is used in 
this example, 
X +X. This instruction 
adds the contents 
of X to itself, 
effectively 
doubling 
the value 
in X. This 
is exactly 
equivalent 
to 
shifting 
X left one bit. If the addition 
of X to itself causes a carry out 
of the high bit of X, it is held for testing in the carry bit. 


16 bit unsigned 
magnitudes 
are held in the X register 
and 
in the DE register 
pair. 
Find their product 
and leave it in 
the BC and HL register pairs, high order in BC. 


label 
SM 
ins!. 
LXI 
MOV 
MOV 


MVI 
DAD 
RCL 


RBL 
X+X 
BNC 


operand 
H,O 
B,H 
C,H 


A,16 
H 


clear low product 
clear high product 
multiply 
step count to A 
register 


shift low product 
left 
propagate 
to high 
product 


shift multiplier 
left 
skip if multiplier 
bit 
zero 
otherwise 
add 


multiplicand 
BNC 
DM2 
test for carry to higher 
order(s) 
INR 
C 
propagate 
carry to third 
order. 
Now we have a 
problem. 
INR does not 
affect the carry bit, but 
some kind of test must 
be made to see if there 
was a carry out of C 
which must be propa- 
gated into the highest 
order in B. The only sit- 
uation 
in which incre- 
menting 
C could cause 
a carry out of its high 
bit is if C contained 
111111112 before the in- 
crementation. 
The re- 
sult of the incrementa- 
tion would be 
000000002• 
The carry 


condition 
would be met 


in this case, and in this 
case only, by a test 
for zero after the 
incrementation 
BNZ 
DM2 
skip if no carry from C 
INR 
B 
propagate 
carry to B 
DM2 
DCR 
A 
decrement 
multiply 
step 
count. 
Since the B regis- 
ter is occupied 
by the 
high order product 
we 
can't use it to hold the 
count and take ad- 
vantage 
of the DBNZ 
instruction 


another step if count 
not zero 


Example 8-5 was an exact double precision parallel of the process 
shown in single precision 
earlier. 
A refinement 
can be made to it, 
however, which will make it even more efficient. 
This depends upon 
the fact that the high product 
is initially zero, the carries from the 
low product 
being shifted into it as they are generated 
in each multi- 
ply step. If the multiplier were to be held in the high product 
area the 
initial product 
shift could be made to serve a dual purpose, 
to shift 
the product 
and to shift a new multiplier 
bit into carry to be tested. 
This would eliminate 
the use of X entirely. 
The multiplication 
re- 
written to take advantage 
of this is shown in example 8-6. 


Double precision unsigned numbers 
are in the BC and DE 
register pairs. Find their product, 
leaving the high order in 
BC and the low order in HL. 


label 
inst. 


DMPY 
MVI 
LXI 
DMPYl 
DAD 
RCL 


RBL 


BNC 


DAD 


BNC 


operand 
A,16 
H,O 
H 


count to A 
clear low product 
shift product left 
shift low product bit 
into high product, 
and multiplier bit into 
carry 
skip if multiplier bit 
zero 
otherwise add 
multiplicand 
skip if no carry to high 
orders 


INR 
BNZ 
C 
DMPY2 
increment third order 
skip if no carry to 
fourth order 
increment fourth order 
decrement count 
and do it again if not 
zero 


INR 
DMPY2 
DCR 
BNZ 


B 
A 
DMPYI 


The program in example 8-6 is both shorter and faster than the 
one in example 8-5. It would be an excellent test of the reader's un- 
derstanding of this material to go back and modify examples 8-3 and 
8-4 to take advantage of the same economies which were made in ex- 
ample 8-6. Double precision signed multiplication 
is done by the 
same general procedure as for single precision in example 8-4. The 
only new twist is that the negation of the product must be done in 
quadruple precision. The process is shown in example 8-7. 


Signed double precision numbers are in the BC and DE 
register pairs. Find their product, leaving the high order in 
BC and the low order in HL. 


label 
ins!. 
operand 
SDM 
MOV 
A,B 
determine product sign 
XRA 
D 
STA 
SIGN 
and save it 
MOV 
A,B 
get high order 
multiplier 
ORA 
A 
test algebraic sign 
JP 
SDMI 
skip if already positive 
ZAR 
clear A for subtract. 
The multiplier will be 


negated by double sub- 
traction from zero 
SUB 
C 
subtract low order 
from zero 
MOV 
C,A 
and replace 
MVI 
A,O 
MVI is used here 
instead of ZAR because 
ZAR would clear the 
carry bit 
SBB 
B 
subtract high order 
from zero, propagate 
carry 
MOV 
B,A 
and replace it 
SDMl 
MOV 
A,D 
now test multiplicand 
sign 
ORA 
A 
JP 
SDM2 
skip if already positive 
LXI 
H,O 
since HL and DE can be 
exchanged we can neg- 
ate the multiplicand by 
direct double subtrac- 
tion. It is not necessary 
to clear carry before 
subtracting. The ORA 
A above left it zero. 
DSC 
D 
form positive 
multiplicand 
XCHG 
and replace it in DE 
SDM2 
MVI 
A,16 
count toA 
LXI 
H,O 
clear low product 
SDM3 
DAD 
H 
shift low product 
RCL 
and higher orders 
RBL 
and multiplier bit to 
carry 
BNC 
SDM4 
skip if multiplier bit 
zero 


DAD 
D 
add multiplicand 
BNC 
SDM4 
skip if no carry to third 
order 
INR 
C 
propagate 
carry to third 
order 
BNZ 
SDM4 
skip if no carry to 
fourth 
order 
INR 
B 
propagate 
carry to 
fourth 
order 
SDM4 
DCR 
A 
decrement 
step count 
BNZ 
SDM3 
and do it again if not 
zero 
LDA 
SIGN 
now get sign indicator 
back 
ORA 
A 
test it for negative 
JP 
SDMS 
skip if product 
positive 
MVI 
D,O 
zero is put into D so it 
can be moved to A as 
needed. 
This is more 
economical 
than the 
four MVI 
A,O instruc- 
tions which would 
otherwise 
be needed 
ZAR 
zero A for first 
subtraction 
SUB 
L 
subtract 
low order from 
zero 
MOV 
L,A 
replace it 
MOV 
A,D 
this again clears A but 
not carry 
SBB 
H 
propagate 
carry 
MOV 
H,A 
replace second order 
MOV 
A,D 
clear A again, but not 
carry 
SBB 
C 
propagate 
carry to third 
order 


MOV 
e,A 
replace third order 
MOV 
A,D 
clear A again but not 
carry 
SBB 
B 
propagate 
carry to 
highest order 
MOV 
B,A 
replace highest order 
SMD5 
program continues 


As with addition 
and subtraction, 
the process of multiplication 
is 
indifferent 
to the placing of any point in the word. Scale factors are 
entirely the business of the programmer 
and if numbers 
with scale 
factors 
are multiplied 
the programmer 
must provide 
any shifting 
necessary to scale the result. If numbers with scale factors A and B 
are multiplied 
the scale factor of the product 
is A + B. Consider the 
multiplication 
of the two pure fractions: 


If the points are ignored and the numbers 
read as integers they are 
12810 and 19210• If the product 
of these numbers 
is found 
by the 
method of example 8-2 it is: 


which is 24,576 if read as an integer. The scale factor of this product 
is the sum of the scale factors 
of the multiplier 
and multiplicand, 
Le., 8 + 8 = 16. To reduce the product 
to the same scale factor 
as 
the multiplier 
and multiplicand 
it must be shifted right eight bits, 
yielding: 


Binary division is done by methods 
which parallel those used in 
pencil 
and 
paper 
decimal 
division. 
A double 
precision 
number 
known as the dividend is divided by a single precision divisor to yield 


two single precision results, the quotient and the remainder. A con- 
straint exists for division in a computer which does not exist for the 
pencil and paper division. The quotient must be expressible in a sin- 
gle computer word, eight bits in the case of the Z80. The condition in 
which the quotient 
cannot be held in a single computer 
word is 
known as the divide fault condition. We will return to divide fault 
shortly. It is sufficient to know here that the high order dividend, 
considered by itself as an integer, must be less in magnitude than the 
single precision divisor. 


The mechanics of the division process are as follows. The double 
precision dividend is shifted left and the high half compared to the 
divisor. If the high half of the dividend is greater than or equal to the 
divisor, the divisor is subtracted from it and the low bit of the quo- 
tient set to one. If the high half of the dividend is less than the divisor 
no subtraction is performed and the low quotient bit is set to zero. 
The quotient is then rotated left. This process is repeated as many 
times as there are bits in the computer word, eight in this case. 
As with multiplication, 
there are economies which can be made by 
combining certain of these functions. As the divisor is shifted left its 
vacated low bits can be used to hold the developing quotient, so that 
the quotient "grows" 
into the space vacated by the left shifting divi- 
dend. The simple division process is shown in example 8-8. 


A double precision dividend is in the HL register pair, 
with the single precision divisor being in D. Divide HL by 
D, leaving the quotient in L and the remainder in H. 


label 
DV 
inst. 
MVI 
MVI 


operand 
D,8 
E,O 
divide step count to B 
clear E. This is 
necessary because the 
DE pair will be used to 
subtract divisor from 
dividend 
shift divisor left. This 


vacates the low bit of L 
which will be used to 
hold the quotient bit 
DSC 
D 
subtract divisor from 
high dividend. The sub- 
traction is done directly 
without the compare. 
If 
the subtraction 
is 
unsuccessful 
it will be 
reversed by the DAD 
D instruction 
below 
BC 
DV2 
if carry was set the high 
dividend was less th:m 
the divisor, Le., the 
subtraction 
was unsuc- 
cessful 
INX 
H 
if there was no carry the 
subtract was successful 
and the quotient bit is 
set to one 
BRA 
DV3 
skip restoration 
of high 
dividend 
DV2 
DAD 
D 
restore high dividend 
DV3 
DBNZ 
DVI 
decrement count and do 
it again if count not yet 
zero 


We must now face the divide fault problem, 
and the constraints 
it 
places on dividend 
and divisor magnitudes. 
Obviously 
the divisor 
cannot 
be zero. Further, 
the high bit of the dividend must not be a 
one, since the DAD 
H would shift this bit out before the first di- 


vide step. Finally, if the high dividend is equal to or greater than the 
divisor, the divide cannot be attempted 
since a quotient greater than 
eight bits would be generated. 
This does not mean that larger quo- 
tients cannot be computed, 
just that it cannot be done with this sin- 


gle precision division. A single precision division which incorporates 
the method of example 8-8 and checks for the divide fault condition 
is shown in example 8-9. 


Example 8-9 


Perform 
the same division as in example 8-8, but check 
for the divide fault condition. 
If there is a divide fault 
send control to location 
DVDFLT, otherwise perform 
the 
division. 


label 
inst. 
operand 
DVD 
MOV 
A,H 
high dividend to A 
ORA 
A 
set flags 
JM 
DVDFLT 
divide fault if high bit 
on 
CMP 
D 
compare high dividend 
to divisor 
BGE 
DVDFLT 
divide fault if high 
dividend greater than or 
equal to divisor. This 
also covers the case of 
zero divisor 
MVI 
B,8 
perform division as 
before 
MVI 
E,O 
DVDl 
DAD 
H 
DSC 
D 
BC 
DVD2 
INX 
H 
BRA 
DVD3 
DVD2 
DAD 
D 
DVD3 
DBNZ 
DVDl 


Division of signed numbers is best done by forcing both dividend 
and divisor positive and adjusting 
the signs of quotient 
and remain- 


der at the end, as was done with the multiplication 
in example 
8-3. 
This will not be covered 
with an example 
here, since the mechanics 
are 
mostly 
repetition 
of 
parts 
of 
previous 
examples. 
Note 
here 
though 
that while the quotient 
sign can be determined 
by Exclusive 
ORing the signs of the divisor 
and dividend, 
the sign of the remain- 
der is always 
the sign of the original 
dividend. 
This 
is to satisfy 
the condition: 


Division 
of a 32 bit dividend 
by a 16 bit divisor 
involves 
exactly 
the same principles 
shown for single precision 
division 
above. 
Some 
special advantage 
can be taken here of the Z80's ability 
to shift any 
register. 
The process is shown in example 
8-10. 


A quadruple 
precision 
dividend 
is in H, L, Band 
C, from 


highest 
order 
to lowest. 
A double 
precision 
divisor 
is in 


DE. Perform 
the indicated 
division 
leaving the quotient 
in 


BC and the remainder 
in HL. If there is a divide fault send 


control 
to DVDFLT. 


label 
ins!. 
operand 


DDVD 
MOV 
A,H 
highest order dividend 
toA 
ORA 
A 
set flags 
JM 
DVDFLT 
cannot 
divide if high bit 


a one 
SHLD 
HDVDND 
store highest two 
dividend 
orders 
SDED 
DVSR 
store divisor 
EXX 
use auxiliary 
registers 
for compare 
LHLD 
HDVDND 
high two dividend 
orders to HL 
I 
LDED 
DVSR 
divisor to DE 
I. Note 


that the SHLD, SDED, 
LHLD and LDED in- 
structions 
used to move 
the high dividend 
and 
divisor here used 14 
program 
words. There 
is a much better way to 
do this which uses only 
4 words. 
This method 
will be discussed 
in 
chapter 
9 
RSC 
clear carry for subtract 
DSC 
D 
subtract 
divisor from 
high dividend 
BNC 
DVDFLT 
divisor less than high 
dividend 
if no carry, 


cannot 
do this division. 
EXX 
get principal 
registers 
back 
MVI 
A,16 
divide step count to A 
DDVDl 
LLC 
shift dividend 
left 
RBL 
DAC 
H 
this DAC brings any bit 
shifted out of B into the 
10wbitofHL 
DSC 
D 
try the subtraction 
BNC 
DDVD2 
successful 
subtraction 
if 
no carry 
DAD 
D 
otherwise 
add it back 
BRA 
DDVD3 
and skip setting 
quotient 
bit 
DDVD2 
INR 
C 
set quotient 
bit to one 
DDVD3 
DCR 
A 
decrement 
step count 
BNZ 
DDVDl 
and do it again if not 
yet zero 


Note when implementing 
this program 
that the quantities 
HDVDND 
and 
DVSR 
are 
two 
words 
long, 
i.e., 
they 
should be defined by: 


HDVDND 
DBL 
0 
DVSR 
DBL 
0 


Failing 
to remember 
this 
will lead 
to some 
mysterious 
errors. 


True 
double 
precision 
multiplication 
and division, 
in which 
the 
numbers 
must 
be operated 
upon 
piecewise, 
is a bit more 
compli- 
cated. 
For multiplication 
both multiplier 
and multiplicand 
are con- 
sidered to be two part numbers, 
the high and low orders 
having 
dif- 
ferent 
scale factors. 
The product 
is then found 
from 
the following 
identity: 


Each of the four multiplications 
generates 
a double 
precision 
prod- 
uct. If the parts of each of these products 
are identified 
by suffixing 
H for high and L for low, the addition 
scheme for the partial 
prod- 
ucts is: 


4th order 
ACH 
3rd order 
ACL 
ADH 
BCH 
ADL 
BCL 
BDH 


If the numbers 
being multiplied 
are pure fraction 
the 1st and 2nd or- 
ders may be neglected 
in the interest 
of enhanced 
speed. 
This will 
tend to make the products 
too small in the low bit of the 3rd order 
since the carry propagated 
from the addition 
of the first two orders 
will be missing. 
For many purposes 
this will make no difference. 
True double 
precision 
division 
usually 
arises in one of two differ- 
ent situations. 
In the first case a quotient 
more than eight bits long is 


required 
from the division 
of a double 
precision 
dividend 
by a single 
precision 
divisor. 
This is the easy case. The first step is to perform 
a 
normal 
division, 
saving the quotient 
from this division 
as the high 
order quotient. 
The remainder 
from this division 
is then used as the 
high dividend 
for the next stage, the low dividend 
being cleared. 
This 
is guaranteed 
to be divisible, 
since the remainder 
is less than the divi- 


sor by definition. 
The quotient 
of this second 
division 
is then saved 
as the second 
order 
quotient. 
The remainder 
from 
the second 
divi- 
sion is then used as a high dividend 
for the third 
stage division, 
the 
low dividend 
again being cleared. 
The quotient 
of the third stage di- 
vision becomes 
the third order quotient. 
This process 
can be carried 
out to any required 
length. 
The second case in which a multiprecision 
dividend 
must be divid- 
ed by a multi precision 
divisor 
is somewhat 
more difficult. 
If the re- 
quired 
precision 
exceeds two it will be simpler 
to simulate 
the effect 
of a normal 
division 
in the required 
length. 
For the double 
precision 
case divisor 
and dividend 
are represented 
as in the multiplication 
case, two part numbers 
with different 
scale factors. 
The quotient 
is 
given by the expression: 


A_+_B= A_+_B__D_(A_+_B_)+ D_ 
2(_A_+_B_) 
... 


C+D 
C 
C2 
C3 


It is easy to see that 
this expression 
converges 
fairly 
rapidly. 
The 
A + B being constant, 
lIC 
may be viewed as a coefficient 
of the first 
term. This amounts 
to division 
by a high order term. The D/C2 
coef- 
ficient of the second term is a division 
of a lower order term by the 
square of a high order term. This is equivalent 
to multiplication 
by a 
low order 
term. 
The D2/C3 
is a multiplication 
by a fourth 
order 
term. 
As with any infinite 
series with terms of alternating 
sign, the 
error 
due to truncation 
is in the direction 
of the last included 
term. 
The three terms 
shown 
above 
will yield a quotient 
good to 29 bits, 
the last bit tending 
to be high because the last included 
term is posi- 
tive. An illustration 
of this type of divide is somewhat 
beyond 
the 
scope of a book like this. If the reader 
is curious 
about 
the specific 
details of the process it will be instructive 
to study the listings of the 
mathematical 
packages 
which come with most minicomputers. 


9 I 
USING THE 
STICK POINTER 


"jack-in-the-box. 
A child's toy, consisting 
of a box, out of which, when the lid is 
raised, a figure springs?' 


Extensive use has been made of the concept of a pointer in the pre- 
vious chapters of this book. The first pointer introduced 
was the 
program counter, a 16 bit register which is used to fetch the next in- 
struction to be executed. Further examples have illustrated the use of 
address pointers held in registers to fetch data from memory. It is 
the purpose of this chapter to illustrate the use of another type of 
pointer which makes possible yet another mod~ of memory access on 
the Z80. This pointer register, known as the stack pointer, is a 16bit 
register which can be loaded from memory by the LSPD instruction 
and stored into memory by the SSPD instruction. 
Like the other 
pointer registers it can also be loaded in the immediate mode by LXI. 
The use of these instructions will be illustrated in the examples of 
this chapter and those which follow. 
Memory access using the pointer registers discussed until now has 
been restricted to accessing one word at a time. The stack pointer is 
different in that reference to memory through it always addresses 
two words at a time. The stack pointer points to an area of memory 
designated by the programmer 
as the stack. The stack may not be 
randomly addressed, but must be accessed as a series of double word 
fetches or stores from 
ascending 
or to descending 
memory 
ad- 
dresses. Data entered into the stack through the stack pointer are 
said to be pushed onto the stack, while data fetched from the stack 
through the stack pointer are said to be popped from the stack. A 
further difference between the stack pointer and the other pointers is 
that the stack pointer is incremented or decremented automatically 
with each stack access. 


The access of data from the stack somewhat resembles accessing 
the trays in the spring loaded tray dispensers found in cafeterias. The 
stack of trays may be of any depth up to the limit of the capacity of 
the device. Starting with the tray dispenser empty, trays may be suc- 
cessivelyloaded into the device, each tray placed on top forcing the 
ones below it down. When the trays are withdrawn from the stack, 
however, only the last one entered may be accessed directly. Popping 
a tray from the stack causes the device to automatically reposition 
itself so that the tray below will be the next one accessed. The dis- 
penser behaves in such a way that the trays are withdrawn (popped) 
in exactly the opposite order from that in which they were entered 
(pushed). 
Data are pushed onto the stack by the PUSH instruction. The as- 
sembler allows this to be spelled either PUSH or PSH. The contents 
of the HL register pair are pushed onto the stack by: 


only the upper register of the pair being named in the operand. 
When this instruction is executed the following series of opera- 
tions occurs: 


2) the contents of the higher order register (H) are stored into the 
memory location pointed to by SP; 


4) the contents of the lower order register (L) are stored into the 
memory location pointed to by SP. 


Note that this stores the contents of HL in exactly the same form, 
low order occupying the lower memory address, as that specified for 
double precision numbers in chapter 7. The Be and DE register pairs 
and the X and Y registers are pushed onto the stack by 


PUSH 
B 
PUSH 
D 


PUSH 
X 
PUSH 
Y 


The stack pointer register itself may not be pushed. The A and F reg- 
isters are considered a register pair for stack operation purposes and 
have the collective name PSW (program status word) when referred 
to as a pair. Do not be misled by this awkward piece of nomencla- 
ture. The PSW consists of two words, A and F, with the F register 
being considered to be the low order register of the pair. The AF reg- 
ister pair is pushed onto the stack by: 


Data are retrieved from the stack by the POP instruction, 
using 
one of the operands already specified for PUSH. When POP is exe- 
cuted the following series of operations takes place: 


1) the contents of the memory location pointed to by SP are loaded 
into the low order register; 


3) the 
contents 
of 
the 
memory 
location 
pointed 
to 
by 
the 
incremented SP are loaded into the high order register; 


A very simple application of PUSH ,and POP is shown in example 
9-1. 


Given that the stack pointer has been loaded elsewhere in 
the program, use PUSH and POP to copy the contents of 
the AF register pair to the AF I register pair. 


PUSH 
PSW 
XAF 
POP 
PSW 


push AF pair onto stack 
set to access AF ' 
load AF' from stack 


It should be understood here that PUSH and POP operations are 
simply special types of load and store instructions. Pushing a register 
pair onto the stack does not change the contents of the register pair. 
Popping memory locations into a register pair does not change the 
contents of the memory locations. A slightly more complex applica- 
tion of PUSH and POP is shown in example 9-2. 


Perform the same operation as in example 6-2, Le., swap 
the contents of the BC and DE register pairs, but this time 
use only PUSH and POP instructions. 
The stack pointer 
has been loaded elsewhere. 


label 
SWAP 
ins!. 
PUSH 
PUSH 
POP 


operand 
B 
D 
B 


push BC pair onto stack 
push DE pair onto stack 
pop former DE 
contents to BC 
pop former BC contents 
toDE 


The most important feature of example 9-2 is that the swap of the 
register pairs required only four memory words for instructions, 
plus four words of reusable stack space. The swap in example 6-2 re- 
quired 16 words for instructions 
and four locations of dedicated 
memory space. Careful use of the stack allows significant economies 
to be made in memory use. Another instance in which using the stack 


as temporary 
storage 
would 
save memory 
is in example 
8-4. In this 
example 
the algebraic 
sign of the product 
of a pair of numbers 
was 
determined 
by an XRA 
A, this 
result 
being 
saved 
by the 
STA 
SIGN instruction 
which followed 
the XRA 
A. The result was later 
retrieved 
by an LDA 
SIGN instruction 
and the flags again set by an 
ORA 
A. 
If, 
instead 
of the STA 
SIGN, 
the AF pair 
had 
been 
saved by PUSH 
PSW, both the A register 
and the flags at the time 
of 
the 
PUSH 
could 
later 
have 
been 
retrieved 
by 
POP 
PSW, 
saving the STA 
SIGN, 
LDA 
SIGN and ORA 
A instruc- 
tions, plus the temporary 
word SIGN itself. These instructions 
occu- 
py eight memory 
words. 
The PUSH 
PSW and POP 
PSW which 
replace them occupy only two. 
The last item pushed 
onto the stack is referred 
to as the top of the 
stack even though 
this item occupies 
the stack location 
with the low- 
est memory 
address. 
This is a confusing 
bit of nomenclature, 
so re- 
member 
it to avoid future 
trouble. 
Data which are pushed 
onto the 
stack 
occupy 
successively 
lower 
memory 
addresses, 
while 
data 
popped 
from the stack are taken 
from 
successively 
higher 
memory 
addresses. 
The 
stack 
can be used 
to access 
data 
for 
arithmetic 
purposes, 
though 
this should 
be done very carefully 
and NEVER 
attempted 
in 
a situation 
in which a program 
interrupt 
can occur. 
Just why this is 
so will have to wait until we cover the subject 
of interrupts, 
but it is 
so. Such a use of the stack and stack pointer 
is shown in example 
9-3. 


A 100 word 
block 
starts 
at location 
LEON. 
This block 
contains 
50 signed 
double 
precision 
numbers. 
Use 
the 
stack pointer 
to retrieve 
the numbers 
and find their sum, 
leaving it in HL. 


label 
inst. 
operand 
MVI 
B,50 
count to B register 
LXI 
SP,LEON 
address 
of beginning 
of 
block to SP 
LXI 
H,O 
clear sum 


pop double precision 
number into DE 
add to sum in HL 
decrement count and do 
it again if not zero 


DAD 
DBNZ 
D 
SUM 


Again, the above technique should never be used in environments 
in which an interrupt can occur, and should never be used at all if the 
nonmaskable interrupt is connected. 
Up until now we have shown only two ways in which the stack 
pointer can be loaded, either directly from memory by LSPD or in 
the immediate mode by LXI. The stack pointer may also communi- 
cate directly with the HL register pair and the X and Y registers. The 
contents of SP may be added to HL, X and Y, by DAD 
SP, X+SP, 
and Y+SP. SP can be loaded directly from HL, X or Y by SPHL, 
SPX and SPY. In addition the two words at the top of the stack, the 
item most recently pushed, may be exchanged with the contents of 
H, X or Y by the XTHL, XTX and XTY instructions. 
The uses of 
these functions will be illustrated shortly. 
At this point the reader should pause and review his understanding 
of the material so far presented in this chapter. If the stack pointer 
use so far described is in any way fuzzy the remainder of the chapter 
will be incomprehensible. A thorough understanding 
of stack opera- 
tions is necessary to understand not just this chapter but most of the 
remainder of the book. 
The data storage and retrieval operations described so far form 
only a small fraction of stack pointer use in the Z80 and other micro- 
computers. 
Indeed the operations 
shown so far could have been 
achieved, albeit clumsily, by other means, as many of them were in 
earlier chapters. What comes next is a class of operations which can 
only be done efficiently by use of the stack. 
Consider for a moment the true double precision multiplication 
described immediately after example 8-10. This operation required 
four multiplications and a series of additions to form the quadruple 
precision product. Using only the information 
developed until now, 


this would have required four copies of the necessary multiplication 
routine. What is required in situations like this is some means of 
keeping one copy of the multiplication routine, jumping to it when a 
product is required, then returning control to a point in the program 
just after the jump to the multiplication routine. Jumping is no 
problem. The multiplication routine might be located anywhere in 
memory and could be jumped to from anywhere in memory. The 
problem is how to get back to the instruction which follows the jump 
to the multiplication routine. 
This could be done using the PCHL, 
PCX 
or PCY instructions. 


These instructions load the program counter with the contents of 
HL, X and Y respectively. X, for example, could be loaded with the 
address to which control is to be returned and the instruction PCX 
added to the end of the multiplication routine. This would look like 
this: 
address of HERE to X 
register 
multiply routine of 
example 8-6 
control would return 
here if the last instruc- 
tion of DMPY were 
PCX. 


This scheme is certainly possible and will work, but suffers from 
the defect that the multiplication routine is deprived of the use of 
one of the fundamental registers of the Z80. This does no harm in 
this case since the DMPY routine does not use X, but the method is 
clumsy and would be unworkable if the situation required the use of 
all available register space. There must be a better way. 
The better way is provided by the Z80 hardware. Recall now the 
heavy emphasis made earlier on the fact that the program counter al- 
ways points to the instruction following the one being executed. If 
the instruction being executed were a jump, the program counter 
would point to the instruction after the jump. PC thus contains ex- 
actly the address we are seeking. There exists in the Z80 a special 
kind of jump which captures the contents of the PC so that they may 
be used to return to the point immediately following the jump. This 


special jump is known as a call. When a call instruction is executed, 
the following steps occur: 


2) the value of the operand of the call instruction is loaded into the 
program counter, forcing control to be transferred to that loca- 
tion. Instruction execution resumes at this new location. 


For the multiplication 
routine 
of example 
8-6 this would be 
written: 


The execution of DMPY would then proceed. To return to the loca- 
tion following the CALL DMPY another special instruction is used. 
This instruction causes the top item in the stack to be popped into 
the program counter, which forces control to that memory address. 
Since the top stack item was the old program counter, this amounts 
to a restoration of the program counter to the value it had when the 
CALL was executed, Le., instruction execution resumes at the loca- 
tion following the CALL. 
This special instruction 
which pops the 
top of the stack into the program counter is known as a return in- 
struction. It is written: 


and must be the last executed instruction of DMPY. The DMPY rou- 
tine now looks like this: 


DMPY 
MVI 
A,16 
LXI 
H,O 
DMPYl 
DAD 
H 
RCL 
RBL 
BNC 
DMPY2 
DAD 
D 
BNC 
DMPY2 
INR 
C 


BNZ 
INR 
DMPY2 
DCR 
BNZ 
RET 


DMPY2 
B 
A 
DMPYI 


The only difference 
is the RET instruction. 
Programs 
organized 
in 
this way are said to be subroutines or subprograms. 
The square 
root 
program 
of example 
4-1 can easily be rewritten 
as a subroutine, 
as 
shown in example 9-4. 


Using the method 
of example 
4-1, construct 
a subroutine 
to extract 
the square root of the number 
in HL on entry to 
the subroutine. 


label 
SQRT 
inst. 
LXI 


RSC 
DSC 
BC 
INX 
INX 
BRA 
LRD 
RER 


operand 
D,l 


D 
END 
D 
D 
LOOP 


this is the point to 
which control 
will be 
transferred 
by the 
CALL. 
It is known as 
the entry point of the 
subroutine 
and the label 
attached 
to this loca- 
tion, in this case SQRT, 
is called the entry point 
name 


remainder 
of routine 
same as in example 4-1 


return to program 
which called SQRT 


The stack may be used for temporary storage within a subroutine 
in the same way as has been illustrated before. It is most important 
that the number of pushes be equal to the number of pops, however. 
If they are unequal the RET instruction at the end of the subroutine 
will pop something other than the old program counter value into 
PC and control will be transferred to somewhere other than the ex- 
pected point. Just where control goes is dependent on exactly what 
was popped into PC by the RET. This leads to an unpredictable re- 
sult which often results in large scale destruction of memory con- 
tents, making it very difficult to trace the error. Failure to equalize 
the number of pushes and pops in a subroutine is a very common 
stack programming error, second only to forgetting to load the stack 
pointer. It is an excellent programming practice to make loading the 
stack pointer the very first instruction of any program. 


The choice of a memory area for use as a stack is up to the pro- 
grammer. If you are very sure of the maximum stack size a fixed 
space in the program may be allocated as the stack area. If the stack 
should grow larger than the allocated space, however, the program 
or some of its operating constants may be destroyed, again leading 
to unpredictable results. A good practice is to use the area immedi- 
ately below the program for stack space. Since the stack grows 
downward with successivepushes the chance for program damage is 
minimized this way. It can still occur, however, if a series of pops in- 
crements the stack pointer into the program area. The first push 
which follows will destroy program words. The debug monitor in 
appendix C contains a feature which will aid the programmer in con- 
trolling this error. This will be discussed in chapter 17. 
The use of the stack area as temporary storage within a subroutine 
is illustrated in example 9-5. 


A subroutine 
is required 
which will fill an area of memory 
with 
a constant 
value. 
The 
value 
to be stored 
into 
the 
block is in the A register on entry. 
The address 
of the first 
word of the block to be filled is in HL and the number 
of 
locations 
to be filled is in BC. Upon 
return 
from the sub- 
routine 
all registers 
and flags are to be in exactly the same 
state as when the subroutine 
was called. 


label 
FILL 
inst. 
PUSH 
PUSH 
PUSH 
PUSH 


MOV 
MOV 


MOV 
MW+R 


operand 
PSW 
H 
B 
D 


D,H 
E,L 


save A and F 
save HL 
save BC 
save DE. Since X and Y 
will not be used it is un- 
necessary 
to save them 
copy HL to DE. This is 
necessary 
because we 
will use MW +R to fill 
the block. The "to" 
ad- 
dress must be in DE 
now increment 
the "to" 
address. 
HL now points 
to the first word of the 
block and DE points to 
the second 
BC originally 
contained 
the total number 
of 
words to be filled. This 
is one more than 
the number 
of moves, 
so BC must 
be decremented 
place value in first word 
fill the block 


POP 
POP 
POP 
POP 
RET 


D 
B 
H 
PSW 


restore DE 
restore 
BC 
restore 
HL 
restore A and F 


There are features 
of example 
9-5 which require 
discussion 
before 
we leave it. The sharpeyed 
reader 
may have noticed 
that the AF reg- 
ister pair was saved, 
but A was not changed. 
The flags were chang- 
ed, however, 
which required 
saving AF. The subroutine 
was written 
as it is to illustrate 
something 
very important 
about 
the stack stor- 
age. If registers 
are to be restored 
to a previous 
state they must be 
popped 
in the exact 
opposite 
order 
from 
that 
in which 
they were 
pushed. 
Make sure you understand 
these operations 
very well before 
trying 
anything 
fancy 
with the stack. 
Remember, 
there 
is no such 
thing 
as a small error. 
Get a program 
that works 
first, 
by the sim- 
plest and most straightforward 
methods 
available. 
This way, if a di- 
saster happens, 
you have something 
to which you can retreat. 


We will leave example 9-5 with one final note. If the content 
of BC 
is zero on entry, 
the grandest 
of all program 
disasters 
will occur - 
nearly 
total 
memory 
destruction. 
It would 
be instructive 
for 
the 
reader 
to examine 
example 
9-5 until he understands 
just what would 
happen 
and why. 
The subroutine 
situations 
examined 
so far have 
all allowed 
the 
numbers 
to be operated 
upon, 
known 
as the arguments of the sub- 
routine, 
to be communicated 
to the subroutine 
in the Z80's registers. 
This will not always be possible, 
either because 
the number 
of argu- 
ments is too large, or for other reasons. 
The problem 
is how to com- 
municate 
the arguments 
without 
using the registers. 
The solution 
to this problem 
is, in many ways, the most difficult 
thing you will encounter 
in this book. 
You may choose to skip over 
it, but you are urged not to do so. It is in the understanding 
of these 
difficult 
topics that your "sweat 
equity" 
in a computer 
is built up. If 
you stay with this and understand 
it your reward will be a real under- 
standing 
of the Z80 stack structure 
and operations, 
allowing 
you to 
use the stack 
with ease and facility. 
This will payoff 
many 
times 


in your future 
programming 
experience with the Z80 and other 
computers. 
One solution to the problem is to store the arguments in a fixed 
area of memory. This gets around the stack problem entirely. The 
subroutine expects to find its arguments in fixed memory addresses 
and leaves its results in fixed memory addresses. This is sometimes a 
useful technique, 
but imposes an overhead 
on all the programs 
which may call the subroutine. 
The arguments must be moved into 
the fixed memory area, called the common 
area, with a series of 
loads and stores, and the results retrieved from the fixed locations 
and stored where required. 
Another solution is to have the arguments themselves, the num- 
bers to be operated upon, occupy the part of memory immediately 
following the CALL instruction. 
This results in a program which 
looks like this: 


CALL 
MUSIC 
JOHN 
*** 
GEORGE 
*** 
PAUL 
*** 
RINGO 
*** 


The numbers JOHN, 
GEORGE, 
PAUL and RINGO are filled into 
the named locations by the calling program. The above sequence is 
known as the calling sequence for the subroutine. The way in which 
the arguments are retrieved is shown in example 9-6. 


A subroutine is required which will find the sum of the 
four numbers in the memory locations immediately fol- 
lowing the CALL to the subroutine. This sum is to be re- 
turned in the A register. Control is to be returned to the lo- 
cation 
following 
the last argument 
(RINGO +1 in the 
above calling sequence). 


label 
ins!. 
operand 
MUSIC 
XTHL 
swap HL with the top 
item on the stack. Since 
the last item pushed on- 
to the stack was the pro- 
gram counter, HL now 
contains the memory 
address of the word 
which immediately fol- 
lows the CALL MUSIC 
instruction, Le., the ad- 
dress of JOHN. JOHN 
itself can be loaded di- 
rectly into A by: 
MOV 
A,M 
move JOHN to A 
INX 
H 
incrementing HL causes 
the register pair to point 
to the word following 
JOHN, Le., to 
GEORGE, which can 
be added directly 
through HL 
ADD 
M 
form sum of JOHN + 
GEORGE 
INX 
H 
increment HL to point 
to PAUL 
ADD 
M 
form sum of JOHN + 
GEORGE + PAUL 
INX 
H 
increment HL to point 
to RINGO 
ADD 
M 
and add RINGO to 
sum. We now have the 
final sum in A, but are 
faced with the problem 
of how to get back to 
the location which fol- 
lows RINGO. HL can 


be made to point to this 
location by: 


control could be 
returned at this point by 
using PCHL to load the 
return address directly 
into PC, but this would 
leave the stack pointer 
changed. The problem 
is to get the desired re- 
turn address into the 
stack so it can be 
popped into PC by the 
RET instruction. This 
can be accomplished by 
the same instruction 
used to get the original 
argument address from 
the stack, namely: 
swap HL with top of 
stack. HL has been re- 
stored to its original 
condition and the re- 
turn address is at the 
top of the stack, ready 
to be popped by: 
return to RINGO +1 


This sequence will work and produce correct results but is subject 
to the same objections as the common storage method, that the se- 
quence must be filled in by the operating program. An even more 
serious limitation is that the method is useless for programs imple- 
mented 
in ROM, 
since the values of the arguments 
cannot 
be 
changed. 
Yet another method is to communicate the address of the begin- 


ning of a string of addresses of the arguments in a register pair. This 
involves a calling sequence that looks like this: 


LXI 
H,ARGSTR 
address of string 
of argument addresses 
toHL 
CALL 
SBRTNE· 
call the subroutine 


with an argument address string, defined elsewhere, that looks like 
this: 


ARGSTR 
DBL 
ARGI 
address of first 
argument 
DBL 
ARG2 
address of second 
argument 
DBL 
ARG3 
address of third 
argument 
etc. 


A subroutine using this kind of calling sequence is shown in exam- 
ple 9-7. 


A series of signed Celcius temperatures for the seven days 
of the week is scattered in various locations in memory. A 
block containing their addresses is created by: 


label 
ins!. 
operand 
TMPTRE 
DBL 
SUNDAY 
address of SUNDAY 
temperature 
DBL 
MONDAY 
address of MONDAY 
temperature 
DBL 
TUESDY 
address of TUESDY 
temperature 
DBL 
WDNSDY 
etc. 
DBL 
THRSDY 


DBL 
FRIDAY 
DBL 
SATRDY 


LXI 
H;fMPTRE 
CALL 
LIMITS 


The 
subroutine 
LIMITS 
is to 
examine 
the 
locations 
SUNDAY 
through 
SATRDY 
and return with the maxi- 
mum temperature in B and the minimum in C. 


INX 
MOV 
H 
D,M 


set maximum register to 
most negative number 
and minimum register 
to most positive num- 
ber. The testing will be 
done by comparing to 
these numbers, replac- 
ing the maximum with 
the value being exam- 
ined if it is greater than 
the previous maximum 
and the minimum with 
the current value if it is 
less than the current 
minimum. Setting the 
registers this way in- 
sures at least one re- 
placement. More on 
this below 
get low order address of 
SUNDAY 
bump pointer 
get high address of 
SUNDAY 


INX 
H 
bump pointer 
LDAX 
D 
finally, get SUNDAY 
temperature in A 
CMP 
B 
compare to high 
temperature 
J< 
LMT2 
skip if less 
MOV 
B,A 
new maximum 
LMT2 
CMP 
C 
compare to low 
temperature 
J>= 
LMT3 
skip if not new low 
MOV 
C,A 
replace old low 
temperature 
LMT3 
MOV 
E,M 
get low address of 
MONDAY, etc. 


This process, beginning with the first MOV 
E,M will be 
repeated 
seven times. After these seven repetitions 
the 
maximum temperature 
for the week will be in B and the 
minimum in C. The only remaining instruction is: 


Such a subroutine has two features which draw the attention im- 
mediately. First, it is a task of repetitious mind-numbing tediousness 
to write and it uses a completely unreasonable amount of memory. It 
was presented this way so that the basic cycle of fetching the address, 
then fetching the temperature could be clearly seen. Now that this is 
understood, 
we can put the entire thing into a loop and produce a 
reasonable version. This is shown in example 9-8. 


Solve the same problem as in example 9-7, but use a loop 
to shorten the program. 


label 
ins!. 
operand 


LIMITS 
MVI 
B,-U8 
load Band C with 
MVI 
C,127 
largest negative and 
positive numbers as 
before 
EXX 
swap register sets 
MVI 
B,7 
load count into B' . This 
is done so that the 
DBNZ instruction can 
be used. X or Y is not 
used because decre- 
menting them sets no 
flags, making the test 
for zero awkward 
LMTI 
EXX 
swap principal registers 
back 
MOV 
E,M 
get low order address 
INX 
H 
bump pointer 
MOV 
D,M 
get high order address 
INX 
H 
bump pointer 
LDAX 
D 
get temperature 
through pointer in DE 
CMP 
B 
compare to high 
temperature 
J< 
LMT2 
skip if less 
MOV 
B,A 
otherwise replace with 
new maximum 
LMT2 
CMP 
C 
compare to low 
temperature 
J>= 
LMT3 
skip if not new low 
MOV 
C,A 
otherwise replace old 
low 
LMT3 
EXX 
swap registers to get at 
count 
DBNZ 
LMTI 
repeat if count not yet 
zero 


otherwise swap to 
access principal 
registers 
and then return 


The purpose of using the largest positive number as the initial 
minimum and the largest negative number as the initial maximum 
was to assure that at least one replacement of both would take place. 
Suppose the maximum and minimum had both been set at zero ini- 
tially, and the temperature 
had varied between 10 and 20 degrees 
over the week. The maximum would have been recorded correctly 
since the first comparison would have replaced the zero, but the min- 
imum would have gone unrecorded, 
since none of the temperatures 
would have been below zero. This would have given the false result 
of a zero minimum. The only safe beginning values are those which 
are sure to be replaced. Notice also that after the test for maximum 
is made the test for minimum is made even if the maximum test 
caused the old maximum value to be replaced. If the MOV 
B,A 
had been followed by a BRA 
LMT3 the routine would have been 
faster, but would have failed in the circumstance in which the tem- 
perature increased each day. If you don't understand why this is so, 
it will be worth your while to work it out on paper until you do. The 
determination of maximum and minimum values in a list of numbers 
is an extremely common programming requirement and you should 
understand how it is done. 
The final method for communication 
of subroutine 
arguments 
that we will consider is that in which the arguments addresses are in 
memory immediately after the CALL instruction. 
This leads to a 
calling sequence that looks like this: 


CALL 
DBL 
DBL 


SUBRTN 
ARGl 
ARG2 
address of 1st argument 
address of 2nd 
argument 
address of 3rd 
argument 


address 
of nth 
argument 


The procedure 
for retrieving 
the arguments 
from this kind of call- 
ing sequence 
is necessarily 
a bit complicated, 
so it will be taken 
in 
two steps. The first step is the poorer 
solution, 
but is easier to under- 
stand and forms the base for understanding 
the second solution. 
The 
first solution 
is shown in example 9-9. 


A subroutine 
is to be constructed 
which will examine 
the 
contents 
of three 
memory 
locations 
whose 
addresses 
are 
given in the calling sequence 
immediately 
after the CALL 
instruction. 
The largest 
of the three numbers 
is to be re- 
turned 
in the A register 
and its address 
in DE. 
Control 
should 
be returned 
to the point immediately 
following 
the 
last argument 
address. 


label 
inst. 
GRTEST 
SSPD 
XTHL 


operand 
SPSAVE 


SPHL 


POP 
H 


MOV 
D,H 
MOV 
E,L 
MOV 
A,M 
POP 
H 


save the stack pointer 
get the old program 
counter 
from the top of 
the stack. This is the ad- 
dress of the first argu- 
ment address 
move the address 
to the 
stack pointer 
address 
of 1st argument 
inH 
copy address 
to DE 


move argument 
to A 
2nd argument 
address 
toHL 


CMP 
M 
compare 1st argument 
to 2nd 
BGE 
GR2 
1st argument greater 
than or equal to second, 
continue test 
MOV 
D,H 
otherwise save address 
of 2nd argument 
MOV 
E,L 
MOV 
A,M 
and get 2nd argument 
to compare to 3rd 
GR2 
POP 
H 
3rd argument address 
toHL 
CMP 
M 
compare greater of first 
two arguments to third 
BGE 
GR3 
skip if A greater than 
3rd argument 
MOV 
D,H 
otherwise replace 
address 
MOV 
E,L 
MOV 
A,M 
and get 3rd argument 
GR3 
LXI 
H,O 
at this point the largest 
of the three arguments 
is in A and its address is 
in DE. The return ad- 
dress must now be re- 
stored to the top of the 
stack and the stack 
pointer itself restored to 
accomplish a proper 
return 
DAD 
SP 
adding SP to the cleared 
HL pair simply trans- 
fers SP to HL 
LSPD 
SPSAVE 
restore the stack pointer 
to its condition on entry 
XTHL 
place return address at 
top of stack 


When we were finished popping the argument addresses 
into HL, the stack pointer contained the address of the 
word which followed the last argument address, i.e., the 
address of the desired return point. Restoring the original 
stack pointer and swapping HL with the top of the stack 
placed this address in the right position to be popped into 
the program counter by the RET. 


Now, it should be clearly understood that this example was includ- 
ed purely for learning 
purposes. 
It will work and produce 
the 
claimed result, but like the earlier use of the stack pointer to pop 
double precision numbers 
in example 9-3, this technique 
should 
NEVER be used if an interrupt is possible, and NEVER be used at 
all if the nonmaskable interrupt is even connected. If the example is 
understood, 
however, it will pave the way to the understanding 
of a 
truly general method 
for argument 
retrieval 
in such calling se- 
quences. This method is shown in example 9-10. 


Solve the problem of example 9-9, but without the use of 
the stack pointer. All other registers may be used. 


label 
ins!. 
GRTESTXTX 


LHX 
LLX 


swap top of stack with 
X register. X now 
points to the address of 
the 1st argument 
high address to H 
low argument address 
to L. These two instruc- 
tions are taking the 


place of the POP 
H 
which brought up the 
argument address in ex- 
ample 9-9 
MOV 
D,H 
save address, same as 
before 
MOV 
E,L 
MOV 
A,M 
get 1st argument 
LHX 
3 
get 2nd argument 
LLX 
2 
CMP 
M 
compare 1st and 2nd 
arguments 
BGE 
GR2 
skip if 1st argument 
greater than or equal to 
second 
MOV 
D,H 
otherwise move 2nd 
argument address to 
DE 
MOV 
E,L 
MOV 
A,M 
and get 2nd argument 
GR2 
LHX 
5 
get 3rd argument 
address 
LLX 
4 
CMP 
M 
compare 2nd argument 
to 3rd 
BGE 
GR3 
skip if A greater than or 
equal to 3rd argument 
MOV 
D,H 
otherwise copy 3rd 
argument address to 
DE 
MOV 
E,L 
MOV 
A,M 
and get 3rd argument 
GR3 
LXI 
B,6 
at this point the return 
address in X must be 
updated. This did not 
occur automatically as 
in 9-9 with the popping 


of the argument ad- 
dresses. The return ad- 
dress must be computed 
by adding the length of 
the argument address 
string to it, Le., 6 words 
for 3 addresses 
this adds the contents of 
BC to X 
place return address at 
top of stack 
and return 


Like example 9-7, this procedure 
could become very tedious if 
there were a large number of arguments involved. The procedure can 
be changed to loop through any required number of arguments by 
incrementing 
X after 
each fetch made through 
it. This would 
amount to changing each 


LUX 
N+l 
LLX 
N 


LLX 
0 
INX 
X 
LUX 
0 
INX 
X 


The count could now be kept in the B register and DBNZ used to 
go through the loop. The BC pair would no longer be required to 
compute the return address, since X would be updated to point to the 
next location after each fetch. If you have really understood the ma- 
terial in this and the preceding chapters you should now be able to do 
this for yourself. 


Like the jump instructions, 
both CALL and RET can be made 
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conditional, 
testing the bits of the F register just as the conditional 
jumps do. The conditional call and return instructions are: 


CNZ 
RNZ 
call or return if result 
was nonzero 
CZ 
RZ 
call or return if result 
was zero 
CNC 
RNC 
call or return if carry 
is zero 
CC 
RC 
call or return if carry 
is one 
CPO 
RPO 
call or return if parity 
is odd 
CPE 
RPE 
call or return if parity 
is even 
CNV 
RNV 
call or return if no 
overflow. This instruc- 
tion is identical to 
CPO/RPO 
CV 
RV 
call or return if 
overflow. This instruc- 
tion is identical to 
CPE/RPE 
CP 
RP 
call or return if result 
was positive 
CM 
RM 
call or return if result 
was negative 


In addition to these conditional calls and returns, the assembler 
supports certain synonyms for use after compare instructions, Le.: 


call or return if equal. 
Assembles as CZ/RZ 
call or return if not 
equal. Assembles as 
CNZ/RNZ 


The following synonyms are used after comparison of unsigned 
eight bit magnitudes. 


call or return if A is 
less. Assembles as 
CC/RC 
call or return if A 
greater than or equal. 
Assembles as 
CNC/RNC 


The following 
synonyms 
are for use after comparison 
of signed 
two's complement 
numbers. 


call or return if A is 
less. Assembles as 
CM/RM 
call or return if A 
greater than or equal. 
Assembles as CP/RP 


A final note on compatibility 
with the 8080. If programs 
are to be 
kept compatible 
they must use no Z80 only instructions, 
Le., no in- 
structions which are flagged by the assembler with a dollar ($) to the 
left of the label field in the assembly listing. There is one area of in- 
compatibility 
which cannot be detected by the assembler, 
however. 
This involves the common use of the PIV flag in the F register to in- 
dicate both parity and overflow. Arithmetic 
instructions 
on the 8080 
set this flag to indicate parity, while it is used to indicate overflow on 
the Z80 by arithmetic instructions. 
If a program is using this flag as a 
parity indicator, 
after arithmetic 
instructions, 
the programmer 
must 
be careful to set the flag to indicate parity rather than the overflow 
state after the arithmetic 
instruction. 
This can be done by executing 
ORA 
A after the arithmetic 
operation 
and before the parity of the 
result is tested. Note here that single register increment 
and decre- 
ment qualify as arithmetic instructions 
for this purpose. Be careful! 
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"Now the engine, from its capability of performing by itself all these 
purely material 
operations, 
spares intellectual 
labor, 
which may be 
more profitably employed. Thus the engine may be considered as a real 
manufactory 
of figures which will lend its aid to those many useful arts 
and sciences that depend on numbers. Again, who can foresee the con- 
sequences of such an invention?" 


Sketch of the Analytic Engine 
Invented by Charles Habbage. 
1842 
L. F. Menabrea 


Many references 
have been made in previous 
chapters 
to blocks of 
data, 
groups 
of numbers 
occupying 
adjacent 
memory 
addresses 
which are connected 
by some common 
purpose. 
These blocks are 
known 
as arrays, and if they contain 
information 
which is to be 
looked up with the aid of some key they are called tables. 
Space for an array may be reserved in the program 
by means of 
the RES (reserve) or BSS (block started by symbol) pseudo-ops. 
RES 
and BSS are identical in meaning. 
They may be preceded by a label 
and if so the label identifies the first word of the reserved block, the 
one with the lowest memory address. Examples are: 


reserve a block of 40010 
locations 
reserve a block 10016 
locations long filled 
with the binary 
equivalent of -510 
(111110112) 
reserve a block 408 
locations long, filled 
with the ASCII code for 
the letter Q 


(110100012). The label 
CUES will refer to the 
lowest memory address 
in the block. 


If the second operand, called the fill value, is omitted, the block will 
simply be skipped over when the program is loaded, the contents re- 
maining unchanged. The operands of an RES or BSS need not be lit- 
eral numbers or characters. The sequence: 


TIGER 
EQU 
BLAKE 
EQU 
NIGHT 
RES 


250 
@77 
TIGER,BLAKE 


will fill a 25010 word block with the value 778• Note that anything 
symbolic which appears in the operand field of RES or BSS must 
have been defined at a point in the program before its use as an oper- 
and. If the definition of TIGER or BLAKE had followed the defini- 
tion of NIGHT above, the assembler would have flagged it as a P er- 
ror, meaning post-defined. This is also true of the ORG pseudo-op. 
Short arrays of ASCII characters can be created by the ASC pseu- 
do-op. The array to be created is enclosed within apostrophes in the 
operand of the ASC, like this: 


The operand field of the ASC may extend all the way to the end of 
the source line. If it overruns the operand field, the assembler will 
move the comment field to the right to accommodate 
it. Arrays of 
ASCII character of any length may be created by use of successive 
ASC pseudo-ops, e.g.: 


ASC 
'IF THIS IS A WRONG NUMBER' 
ASC 
' WHY DID YOU ANSWER THE PHONE?" 


Note when doing this that if the line is broken at a boundary between 
words, the blank between the words is not supplied automatically. 
The second ASC above begins with a blank for this reason. 


Perhaps the simplest of all operations on an array is to search it 
for some value. One way of doing this is shown in example 10-1. 


label 
OSCAR 
ins!. 
ASC 
operand 
'VTGQHKAP' 


Create a subroutine to search this array for the character 
in the A register on entry. If the character is found, return 
with carry off and the ordinal position of the character in 
the array in C. If the character is not found in the array re- 
turn with carryon. 


CSRCH 
LXI 
H,OSCAR 
address of OSCAR to 
HL pair 
MVI 
B,8 
count of characters to B 
MVI 
C,t 
1 to C. This will be 
incremented for each 
unsuccessful compare 
CSRCH2 
CMP 
M 
compare character in A 
to memory 
BEQ 
GOTCH A 
skip out of loop if 
found 
INX 
H 
otherwise increment 
pointer 
INR 
C 
and ordinal array 
number 
DBNZ CSRCH2 
decrement count and do 
it again 
STC 
character not in 
OSCAR array, turn 
carryon. 
RET 
and return 
GOTCHA 
RSC 
character found, clear 


carry 
return with ordinal 
number inC 


Example 10-1could have been made more efficient in a number of 
ways. The most obvious economy is in replacing the second and 
third instructions with a single instruction, LXI B,:801, which would 
have loaded both registers at once, saving a word of memory. The 
most significant economy, however, could have been made by using 
a special Z80 facility, the CP+ and CP+R instructions. The instruc- 
tions function somewhat like the MW+ and MW+R instructions de- 
scribed in chapter 6. The word in A is compared to the memory 
word, the HL pointer incremented, and the BC counter decrement- 
ed. In the case of CP+ the flag bits are set as for an ordinary com- 
pare, excepting the overflow flag. If the word in A was equal to the 
word in memory the Z bit will be set and tested with a BEQ or BNE 
instruction. The overflow flag will be on if the execution of the CP+ 
did not cause the count in BC to become zero, and off if it did be- 
come zero. The use of CP+ is shown in example 10-2. 


Search the array OSCAR as in example 10-1,this time us- 
ing the CP+ instruction. 


label 
inst. 
operand 


ASRCH 
LXI 
H,OSCAR 
array address to HL 
LXI 
B,8 
count to BC 
ASRCH2 
CP+ 
perform the 
comparison 
BEQ 
EUREKA 
skip if equal compare 
JV 
ASRCH2 
count not zero if 
overflow on 


RET 
EUREKA 
PUSH 
PSW 
MOV 
A,C 


MOV 
C,A 
POP 
PSW 
RSC 


set carry, character not 
found 


save character in A 
move low count to A. 
This is a number be- 
tween 0 and 7,7 if the 
character was V and 0 if 
it was P, exactly the 
opposite of what is 
required. The 0-7 range 
is because BC was 
decremented by the 
CP+ 
subtract 8. This creates 
a number between-l 
and -8, -1 if the 
character was V and -8 
ifit was P 
negate the number. This 
generates a number 
from 1 to 8 as required 
move number to C 
restore AF 
clear carry for 
successful search 
return to calling 
program 


An even more efficient way to do the job is to use the repeating 
form of CP+, CP+R. When CP+R is executed the program counter 
is automatically 
decremented after each step in which BC has not 
become zero. This makes an elegant way to search an array for some 
value. The use of CP+ R is shown in example 10-3. 


Example 10-3 


Again solve the problem 
of example 10-1, but use the 
CP+R instruction. 


label 
inst. 
operand 
SRCH 
LXI 
H,OSCAR 
address of OSCAR 
toHL 
PUSH 
H 
push onto stack 
POP 
D 
copy to DE. This time 
we will generate the po- 
sitional number in the 
array a different way 
LXI 
B,8 
count to Be, as before 
SRCH2 
CP+R 
search the array. The 
CP+R will stop when 
an equal compare has 
been found or when the 
count has been exhaust- 
ed. If the count is ex- 
hausted first the over- 
flow flag is set as for 
CP+ 
BEQ 
FOUND 
skip if equal compare. 
If control gets beyond 
the BEQ the count went 
to zero. It is therefore 
unnecessary to check 
overflow 
STC 
carryon for 
unsuccessful search 
RET 
and return 
FOUND 
RSC 
clear carry for subtract 
LXI 
D,OSCAR 
array address to DE 
DSC 
D 
this forms the 
difference between the 
address of the first ar- 


ray member and the ad- 
dress of the matching 
character plus one, 
since the CP+R auto- 
matically incremented 
HL one past the match- 
ing character 
move number to C as 
required. Carry is al- 
ready zero, since the 
DSC cannot have 
caused it to be set in 
these circumstances 
return to calling 
program 


Most often the table to be searched will not be composed of single 
element entries as in the above examples, nor will the requirement be 
to return the simple table position at which the entry is found. What 
is usually required is that a table of multiple element entries be 
searched and the corresponding multiple element entry in a parallel 
table be returned. This situation is shown in example 10-4. 


Two parallel tables exist in memory. The first consists of 
four character names of products. This table originates at 
PRTBLE. The second table, beginning at DTBL, consists 
of two word entries, the first being the product class and 
the second the price. The name to be searched for is in lo- 
cations PRNAME through PRNAME + 3. Search PRTBL 
for the name given in PRNAME through PRNAME + 3. 
If the item is found return its price in H and product class 
in L. If the item is not found return with FFFF 16inHand 
L. The tables look like this: 


label 
ins!. 
operand 
PRTBL 
ASC 
'MILK' 
ASC 
'EGGS' 
ASC 
'BEER' 


ASC 
'MEAT' 
ASC 
'CORN' 


etc. 


DTBL 
DATA 
0,40 
class 0, 40 cents per 
quart 
DATA 
5,68 
class 5, 68 cents a dozen 
DATA 
3,88 
class 3, 88 cents a quart 
DATA 
2,169 
class 2, $1.69 a pound 
DATA 
9,55 
class 9, 55 cents a can 


There 
are 72 different 
items 
in the table, 
so we define 
TBLSIZ: 


PRSRC 
MVI 
B, TBLSIZ 
table size to B 
LXI 
H,PRTBL 
name table origin to HL 
PRSRC1 
LXI 
D,PRNAME 
address 
of name to be 
found to DE 
LDAX 
D 
first character 
of name 
toA 
SUB 
M 
subtract 
first character 
of table name 
INX 
D 
increment 
both address 
pointers 


MOV 
C,A 
and save difference 
in C 
LDAX 
D 
get second name 
character 
SUB 
M 
subtract 
second 
character 
of table name 
INX 
D 
increment 
both address 
printers 
INX 
H 
ORA 
C 
OR with former 
result 
MOV 
C,A 
and save again in C 
LDAX 
D 
get third name 
character 
SUB 
M 
subtract 
third table 
name character 
INX 
D 
increment 
both pointers 
INX 
H 
ORA 
C 
OR again 
MOV 
C,A 
save in C 
LDAX 
D 
get last name character 
SUB 
M 
subtract 
last table name 
character 
INX 
D 
increment 
pointers 
INX 
H 
ORA 
C 
OR for final result. 
If 
the result of this OR is 
zero, all four subtrac- 
tions were zero and the 
names were identical. 
Had addition 
been used 
instead, 
the names 
MEAT and MAET 
would have compared 
identical 
BZ 
WOOPEE 
found it if zero here 
DBNZ 
PRSRCI 
do it again if not last 
table entry 


LXI 
H,-l 
if control reaches here 
the name was not in the 
table 
RET 
return with fail code in 
HL 
WOOPEE 
LXI 
D,PRTBL 
address of table origin 
to DE 
DSC 
D 
form difference 
between address of 
name and table origin. 
Note that this number 
will be a multiple of 4 
since each PRTBL entry 
was 4 characters long. 
Note also that it will be 
four too large since the 
pointers were incre- 
mented before the final 
test. It was unnecessary 
to clear carry before 
subtracting. This was 
done by the ORA 
C 
above 
LRH 
divide HL by two by 
shifting right 
RLR 
we now have a table 
displacement in HL 
suitable for use with 
DTBL. It is still two 
greater than the re- 
quired value for the 
same reason that the 
computed displacement 
above was four too big. 
We could fix this by 
decrementing twice, but 
there is a better way 


address of word two 
below the beginning of 
DTBL 
add this to the 
displacement in HL 
product class E 


. bump pointer 
price to D 
product class to L, price 
toH 
and return to calling 
program 


MOV 
E,M 
INX 
H 
MOV 
D,M 
XCHG 


The method of example 10-4is very important. Be sure you under- 
stand what went on here before proceeding. The computation of dis- 
placements in this way is extremely common. The final touch can be 
put on this table search by getting rid of all the repetition involved in 
fetching the names from memory. This is done by having all of the 
fetching and comparison done in a subroutine. This is shown in ex- 
ample 10-5. 


Solve the same problem as in example 10-4, but put the 
data fetching and comparison 
into a loop to cut down 
memory use. 


label 
inst. 
operand 
PRSRC 
MVI 
B,TBLSIZ 
prolog same as before 
LXI 
H,PRTBL 
PRSRCl 
CALL 
CMPARE 
call comparison 
subroutine 
BZ 
WOOPEE 
return from subroutine 
with flags set 


DBNZ 
PRSRC1 
LXI 
H,-1 
RET 


The remainder of the program, beginning at WOOPEE is 
the same. The comparison subroutine poses an interesting 
problem, however. We would like to use the B register to 
count the four comparisons, 
but it is already in use to 
count through the main table. The solution is as follows: 


save main program's 
BC register pair 
load B with 4 and C 
with 0 
D,PRNAME 
address of name to DE. 
The table pointer is 
already in HL 
get name character 
subtract table character 
OR with result 
save new result 
increment both pointers 


LDAX D 
SUB 
M 
ORA 
C 
MOV 
C,A 
INX 
D 
INX 
H 
DBNZ 
CM1 
POP 
B 
decrement count 
restore main program 
BC. Neither the POP, 
the DBNZ nor the 
INX's has any effect on 
the flags. The flags 
therefore are in the 
state set by the 
ORA 
C. Since this is 
the final test of the four 
it will be zero if all of 
the subtractions yielded 
zero 


return to calling 
program 
with flags set 
for test by HZ 


A final refinement 
can be put on the method 
by abolishing 
the sep- 
arate 
tables. 
Instead, 
a single table 
containing 
alternate 
name 
and 
code entries is established. 
This table has the form: 


ASC 
DATA 
ASC 
DATA 


'MILK' 
0,40 
'EGGS' 
5,68 


and so forth. 
The search 
of such a table differs 
from those already 
shown only in that the table pointer 
must be incremented 
twice more 
after 
each unsuccessful 
compare 
to make 
it point 
to the next table 
entry. We will not bother 
with a formal 
example 
of this here, but the 
reader 
is urged to look in the source listing of the assembly 
program 
at location 
OPSRC. 
This 
is the program 
which 
searches 
the Z80 
mnemonic 
table 
for 
the instruction 
the programmer 
has 
written. 
Each of the four word mnemonic 
entries 
is followed 
by two words 
specifying 
the instruction 
class, Le., what 
kind of processing 
is re- 
quired, 
and the binary 
skeleton 
of the instruction. 
Keep in mind that 
this and all other parts of the assembler 
use only the 8080 instruction 
subset. 
It would 
be an instructive 
exercise 
for the reader 
to rewrite 
this OPSRC 
routine 
to take 
advantage 
of economies 
possible 
with 
the added Z80 instructions. 


Another 
common 
operation 
performed 
on arrays 
is known 
as 
sorting, 
the rearrangement 
of the members 
of the array in the small- 
est to largest 
or largest 
to smallest 
order. 
A vast amount 
of effort 
and ingenuity 
has gone into finding 
efficient 
solutions 
to this prob- 
lem, occurring, 
as it does, so commonly 
in commercial 
applications. 
We will illustrate 
a very simple sorting 
method 
here known 
as a bub- 
ble sort. In a bubble 
sort adjacent 
array members 
are compared 
and 
switched 
if the comparison 
condition 
is met. 
If the array 
is being 


sorted from smallest to largest the condition is that array member N 
is larger than array member N+1. The contents of N are swapped 
with the contents of N + 1 and the next comparison, 
between N+1 
and N+2 is made, the same process being repeated. In this way the 
largest member of the array is "floated" 
to the top in the first pass. 


There are a couple of things about this process which may not be ob- 
vious on the face. First, for an array of K members, there are K-l 
comparisons 
to be done on each pass, and second, after each pass 
through the array the number of comparisons decreases by one since 
each pass "floats" 
the largest remaining number to the top. At the 
beginning of each pass a counter is set to zero. Each time a swap is 
made during the pass this counter is incremented. At the end of each 
sorting pass the counter is tested. When an entire pass through the 
array is made with no swaps the array is sorted. A very simple sort of 
this kind is shown in example 10-6. 


A bubble sort subroutine is required which will sort an ar- 
ray into order so that the smallest member occupies the 
lowest memory address. The numbers in the array are un- 
signed eight bit magnitudes. The address of the beginning 
of the array is held in HL on entry and the size of the array 
is in B. Return with carryon 
if the initial size of the array 
is given as zero, otherwise sort the array and return with 
carry off. 


Advantage can be taken here of the Z80's indexed address- 
ing capability. If X contains the address of an array mem- 
ber, that member can be loaded into A by LAX 
0 and 
compared to the following array member by CMPX 
1. 


This eliminates the necessity for keeping and incrementing 
two pointers. The subroutine is shown below. 


label 
SORT 
ins!. 
ZAR 
clear A for test of array 
size 


ORA 
B 
set flags 
BZ 
SORTS 
array size zero, return 
with carryon 
MVI 
C,O 
clear swap count in C 
SORTl 
PUSH 
H 
transfer array address 
POP 
X 
fromHL 
to X 
DCR 
B 
decrement comparison 
counter. On the first 
pass this adjusts the 
count to K-l, where K 
is the array size. On 
succeeding passes it 
decrements to allow for 
the fact that the largest 
member found in the 
last pass is already at 
the top 
BZ 
SORT4 
the number of 
comparisons to be 
made is less than or 
equal to the number of 
swaps, by definition. If 
this number becomes 
zero the array is com- 
pletely sorted 
PUSH 
B 
save Band C 
SORT2 
LAX 
1 
get N+1 array 
member 
CMPX 
0 
compare to Nth array 
member 
BGE 
SORT3 
skip if Nth less than 
N+lst 
LDX 
0 
otherwise swap Nth and 
N+lst 
SAX 
0 
SDX 
1 


INR 
C 
increment swap counter 
SORT3 
INX 
X 
increment array pointer 
DBNZ 
SORT2 
decrement count and 
repeat 
ZAR 
clear A for test for swap 
count 
ORA 
C 
test swap counter 
POP 
B 
this retrieves the 
comparison count from 
the stack and clears C 
for the next pass 
through the array, since 
C was cleared before 
BC was pushed above. 
This POP did not 
change any of the flags. 
They are still as they 
were set by the 
ORA 
C 
BZ 
SORT4 
skip if swap counter 
zero 
BRA 
SORTl 
otherwise do it again 
SORT4 
RSC 
clear carry for normal 
return 
RET 
return to calling 
program 
SORTS 
STC 
set carry for zero array 
size 
RET 
return to calling 
program 


Without the use of the index plus displacement addressing facility 
of the Z80 this program would have been much longer. To see just 
how much longer the reader may consult example 9-4 of the author's 
earlier 
Practical 
Microcomputer 
Programming: 
The Intel 
8080 
(Northern Technology Books, 1976). 


One of the most common sorting requirements is for the sorting of 
a table of multilength character data into alphabetic order. The same 
principles apply to this kind of sort as to the simple sort we have just 
seen, but the mechanics get a little bit more complicated. A require- 
ment like this arises when writing assembly programs. Each symbol 
used as a label is entered into a symbol table, which is printed at the 
end of the assembly. To be useful as a program reference it must be 
put into alphabetic order. If the reader has need of such techniques 
he is urged to examine the SRTST routine in the assembler listing. 
This routine uses a simple bubble sort of the type illustrated here. 
This is efficient enough for the relatively small numbers of symbols 
that have to be sorted by an assembler. If large amounts of alphabet- 
ic data are to be sorted, however, other techniques than the bubble 
sort should be examined. Descriptions of these techniques are availa- 
ble in a variety of places, in particular 
consult Flores' 
Computer 
Sorting (Prentiss-Hall, 
1969). 


The final table lookup technique to be considered here is that in 
which the incoming argument can be used to directly calculate the ta- 
ble position of the required quantity. This is shown in example 10-7. 


A subroutine 
is required which will transform 
a voltage 
read from a thermistor to a temperature. 
The thermistor 
voltage will be represented by a binary number between 
-20 and + 35. The number representing voltage is to be 
used as a displacement to look up the corresponding tem- 
perature in a table which begins at DGREEZ. 
If the num- 
ber representing voltage is in the range -20 to + 35 look up 
the temperature 
and return it in A with carry off. If the 
number representing voltage is out of this range return 
with carryon. 
The incoming number representing voltage 
is in the A register. 


label 
inst. 
THMSTR 
CPI 
J>= 


operand 
36 
BUMMER 
compare for upper limit 
jump must be used 


because there are no 
branch instructions 
which test the sign flag 
CPI 
-20 
compare for lower limit 
J< 
BUMMER 
below bottom of range 
ADI 
20 
normalize range to zero 
MOV 
E,A 
save number 0-55 in E 
for displacement 
MVI 
D,O 
clear upper 
displacement 
LXI 
H,DGREEZ 
address of table to HL 
DAD 
D 
address + displacement 
= address of required 
table entry 
MOV 
A,M 
get table entry 
RSC 
clear carry 
RET 
return to calling 
program 
BUMMER STC 
carryon for error 
return 
RET 
return to calling 
program 
DGREEZ 
DATA (-) 
temperature 
corresponding to 
voltage reading -20 
DATA (-) 
temperature 
corresponding to 
voltage reading -19 
etc. 


Before leaving this example, note that an economy could have 
been made by combining the addition of the 20 with the test for the 
low limit. The sequence: 


J< 
BUMMER 
ADI 
20 


ADI 
20 
JM 
BUMMER 


which would save two words. 
An 
even 
faster 
method 
for 
accomplishing 
this 
depends 
on a 
knowledge 
of the Z80's 
detailed 
binary 
instruction 
structure. 
The 
displacement 
of an indexed instruction 
is in the third word of the in- 
struction. 
This displacement 
can be directly filled in by the program, 
thus saving the tedious address computation 
in DE and HL of exam- 
ple 10-7.The reader is warned that this method cannot be implement- 
ed in ROM, and further that it will be frowned upon by devotees of 
pure procedure 
programming 
and other priestly persons. 
The meth- 
od is shown in example 10-8. 


Perform 
the table lookup described in example 10-7 by di- 
rect modification 
of the displacement 
of the indexed ac- 
cess instruction 
as described above. 


store directly into 
displacement 
to LAX 
X,DGREEZ+20 
table address plus 
offset to X 
fetch table item. The 
displacement 
of this 
LAX has been filled in 


label 
THRMS 
inst. 
operand 
CPI 
36 
J>= 
NOGOOD 
CPI 
-20 
J< 
NOGOOD 
STA 
INST+2 


above with the incom- 
ing number, elimi- 
nating the address 
computation 
clear carry 
return 
set carry for error 
return 
return 


RSC 
RET 
NOGOODSTC 


While this is much shorter and faster than the conventional meth- 
od, the reader is again warned that it will not work in ROM because 
of the direct modification of a program instruction. 


11 I 
DECIMAL 
ARITHMETIC 


Before beginning to discuss decimal arithmetic it is necessary that 
we define exactly what is meant by a decimal number in a binary 
computer like the Z80. Decimal digits are represented as four bit 
groups which are the binary equivalents of the decimal digits. This 
system of representation is known as binary coded decimal or BCD. 
The decimal number 94 is represented in an eight bit Z80 word: 


the upper for bits being the nine and the lower four bits the four. 
BCD constants can be generated by the assembler as a special case of 
hexadecimal, i.e.: 


lower address 
01000111 
higher address 
00110001 


In BCD the values 10102 through ll1b 
have no numerical meaning. 


It must be understood at the outset that neither the Z80 nor any 
other existing microcomputer can perform decimal arithmetic. The 


arithmetic of the Z80 is binary and only binary. What the Z80 can do 
is to rectify the result of a binary addition or subtraction of eight bits 
to yield a numerically correct BCD result. This is done by means of 
the DAA instruction. Consider the two BCD numbers: 


When these numbers are added with one of the various ADD instruc- 
tions of the Z80 the result is: 


which makes no sense in decimal. If the DAA instruction is executed 
immediately after the addition, the sum will be adjusted to: 


the correct BCD result. Just how this is done is of no relevance here. 
The fact that it is done is all that matters for programming. 
The 
DAA must be executed after the addition and before any other in- 
struction which alters the flags. The addition of a pair of BCD num- 
bers is shown in example 11-1. 


A pair of two digit BCD numbers is in Band 
C. Form 
their sum and leave it in A. 


ins!. 
MOV 
ADD 
DAA 


operand 
A,B 
C 
augend toA 
form sum with addend 
adjust for correct BCD 
representation 


The DAA will also set the carry bit if the BCD sum generated was 
greater than 99. This carry can be used to propagate the sum to high- 
er orders, allowing multiple precision BCD addition. This is shown 
in example 11-2. 


Double precision (4 digit) BCD numbers are in the BC and 
DE register pairs. Add the numbers and leave their sum in 
DE. Since addition of a pair of four digit numbers may re- 
sult in a fifth digit, leave this digit in L. 


label 
inst. 
operand 
DBLADD 
MOV 
A,C 
ADD 
E 
DAA 
MOV 
E,A 
MOV 
A,B 
ADC 
D 
DAA 
MOV 
D,A 
MVI 
A,O 


low augend to A 
form low sum 
adjust for correct BCD 
save low sum 
get high augend 
form high sum 
adjust for correct BCD 
save high result 
MVI 
A,O is used 
because it does not dis- 
turb the flags as ZAR 
would 
propagate carry to fifth 
digit 
fifth sum digit in L 


This process may be carried out to any required precision. The ad- 
dition is carried out from low order to high, the lowest orders being 
added with a simple add, and all higher orders being added with car- 
ry from the lower orders. 


It should be understood 
that the numbers being added must be 
correct BCD to begin with, or the result will not be valid. In particu- 
lar, it must be clear that DAA will not perform binary to decimal 


conversion. 
It will only rectify the result of the addition 
or subtrac- 
tion of two proper 
BCD numbers. 
A long addition 
of the sort which 
might arise in a commercial 
application 
is shown in example 
11-3. 


Example 
11-3 


A twelve digit BCD number 
at TED is to be added to a ten 
digit BCD number 
at SINGER, 
the sum being left in TED. 
Perform 
the 
addition 
using 
the 
X and 
Y registers 
as 
pointers. 


label 
inst. 
operand 
LXI 
X;fED 
address 
of low order 
TEDtoX 
LXI 
Y,SINGER 
address 
of low order 
SINGERtoY 
LAX 
0 
low order TED to A 
ADDY 
0 
form low order sum 
DAA 
decimal adjust 
SAX 
0 
store in low order TED. 
Note that the low order 
addition 
was done with 
ADDY not ADCY 
LAX 
1 
second order TED to A 
ADCY 
1 
now ADCY is used to 
propagate 
the carry 
from the low order 
DAA 
decimal adjust 
SAX 
1 
store second order 
LAX 
2 
get third order TED 
(5th and 6th digits) 
ADCY 
2 
form third order sum 
DAA 
decimal adjust 
SAX 
2 
store third order 
LAX 
3 
get 7th and 8th digits 
of TED 
ADCY 
3 
form fourth 
order sum 


DAA 
decimal adjust 
SAX 
3 
store fourth order 
LAX 
4 
get 9th and 10th digits 
of TED 
ADCY 
4 
form sum 
DAA 
decimal adjust 
SAX 
4 
save fifth order. Now 
we have exhausted all 
the digits of SINGER, 
but still have two digits 
of TED to go. This 
amounts only to propa- 
gating the carry from 
the fifth order addition 
into the sixth 
LAX 
5 
get 11th and 12th TED 
digits 
ACI 
0 
propagate carry 
DAA 
decimal adjust highest 
order result 
SAX 
5 
and store in TED. If the 
sum exceeded 12deci- 
mal digits the carry bit 
would be on here 


The DAA instruction can also rectify the result of a BCD subtrac- 
tion. A simple single precision subtraction is shown in example 11-4. 


A pair of two digit BCD numbers is in the Band C regis- 
ters. Find their BCD difference (B-C) and leave it in A. 


inst. 
MOV 
SUB 
DAA 


operand 
A,B 
C 
minuend toA 
minus subtrahend 
decimal adjust 
difference 


As with addition, the carry bit is set in such a way as to allow pro- 
pagation of a borrow to a higher order in multiple precision BCD 
subtraction. A double precision is shown in example 11-5. 


A pair of double precision BCD numbers is in BC and DE. 
Find their double precision difference (BC-DE) 
and leave 
it in DE. 


label 
inst. 
operand 
DSUB 
MOV 
A,C 
low order minuend to A 
SUB 
E 
form low binary 
difference 
DAA 
adjust to BCD 
MOV 
E,A 
save low order BCD 
difference 
MOV 
A,B 
high order minuend 
toA 
SBB 
D 
form low BCD 
difference 
DAA 
adjust to BCD 
MOV 
D,A 
high order BCD 
difference to D 


The absence of an algebraic sign in BCD arithmetic raises a prob- 
lem when the subtrahend is greater than the minuend. In this case the 


difference is represented as the ten's complement of the true BCD 
difference, corresponding 
to a negative result in signed arithmetic. 
This is always detectable by testing carry after the highest order sub- 
traction and decimal adjust. If the result is valid BCD the carry bit 
will be off. If the result is a ten's complement negative number the 
carry bit will be on. What to do if this happens is a matter of the us- 
er's choice. One procedure would be to use one of the codes 10102 - 
11112as a sign, either beginning or ending each BCD string this way. 
Conversion 
of a ten's complement number to true BCD involves 
subtraction 
of each order from the maximum two digit BCD num- 
ber, 99. The other alternative is to perform the subtraction 
again, 
swapping minuend and subtrahend. 
There are two other Z80 instructions besides DAA which pertain 
to BCD arithmetic, 
RLD and RRD, meaning rotate right decimal 
and rotate left decimal. Both of these instructions operate between 
the low four bits of A and the memory word pointed to by HL. In 
RRD the low four bits of A replace the high four bits of the memory 
location and the high four bits of the memory word are moved to the 
low four bits of the memory word. The former low four bits of the 
memory word are loaded into the low four bits of A. The high four 
bits of A remain unchanged and do not participate in the operation. 
In RLD the high four bits of memory word are moved to the low 
four bits of A, the low four bits of the memory word move to the 
high four bits of the memory word and the former contents of the 
low four bits of A replace the low four bits of the memory word. 
Again, the high four bits of A remain unchanged and do not partici- 
pate in the operation. 
RLD and RRD allow true decimal shifts to be performed. A deci- 
mal left shift is shown in example 11-6. 


An eight digit BCD number is in memory at locations 
NEWT through NEWT+3, the lowest order being NEWT. 
Perform 
a decimal left shift of NEWT, ending with the 
digit shifted out in A. 


label 
ins!. 
operand 
DLSHF 
LXI 
H,NEWT 
address of NEWT 
toHL 
ZAR 
clear A to shift in zero 
at lo·.vend 
RLD 
shift low order 
INX 
H 
pointer to second order 
RLD 
shift second order 
INX 
H 
pointer to third order 
RLD 
shift third order 
INX 
H 
pointer to highest order 
RLD 
shift highest order. The 
digit shifted out is now 
inA 


In example 11-6the A register was cleared before the first shift to 
bring a zero into the vacated digit position. If a digit were to be shift- 
ed into this position it should be loaded into the low order four bits 
of A before the first shift. 


Decimal right shifts are done in essentially the same way except 


that the address in HL is that of the highest order and the pointer is 
decremented rather than incremented. 
This is obvious enough that 
an example here would be superfluous. 
The ability to do true decimal shifts allows decimal multiplication 
and division to be performed fairly easily. This is a first for the Z80, 
the labor of shifting a BCD digit at a time having made the effort 
less than worthwhile on previous microcomputers. 


Multiplication proceeds almost exactly as it does on paper. Multi- 
plier digits are tested from right to left and the multiplicand added to 
a prezeroed product. At the end of each multiply step the multipli- 
cand is shifted left, corresponding 
to the indentation 
of the succes- 
sive product lines in pencil and paper multiplication. 
The process is 
shown in example 11-7. 


A subroutine is required to find the product of two four 
digit BCD numbers held in HL and DE. The high order 
product should be returned in HL and the low order in 
DE. 


label 
ins!. 
operand 
DCMPY 
SHLD MPLR 
entry point, save 
multiplier 
SDED MCND 
save multiplicand 
LXI 
H,O 
zeroHL 
SHLD MCND+2 
clear four digits above 
multiplicand. This is 
because the multipli- 
cand will be shifted left 
into this space 
SHLD PROD 
clear product area 
SHLD PROD+2 
LXI 
X,PROD 
address of low order 
product to X 
LXI 
Y,MCND 
and low order 
multiplicand to Y 
MVI 
B,4 
multiply step count to B 
DCMPYI 
PUSH 
B 
save count on stack 
LXI 
H,MPLR+l 
address of high 
multiplier to HL 
ZAR 
clear A to shift 
multiplier right 
RRD 
shift high order 
multiplier right 
DCX 
H 
point to low order 
RRD 
shift low order 
multiplier to right. The 
digit shifted out is in A 
BZ 
DCMPY3 
skip if multiplier digit 
zero 


ADDY 
0 
DAA 
SAX 
0 
LAX 
1 
ADCY 
1 


DAA 
SAX 
1 


LAX 
2 
ADCY 
2 
DAA 
SAX 
2 
LAX 
3 
ADCY 
3 
DAA 
SAX 
3 


otherwise use digit as 
counter 
add multiplicand 
to product 


save low order product 
second order 
ADC to propagate 
carry from low order 


store second order 
product 
third order 
again, propagate carry 


save third order 
fourth order 


save fourth order. The 
loop which begins at 
DCMPY2 and ends 
with the DBNZ which 
follows is executed the 
number of times given 
by the multiplier digit 
shifted out above 
repeat if multiplier digit 
not exhausted 
now shift multiplicand 
left 
clear A to avoid 
bringing in extraneous 
garbage into the low or- 
der digit 


LHLD 
PROD+2 
RET 


shift low order 
point to second order 
shift second order 
point to third order 
shift third order 
point to fourth 
order 
shift highest order 
retrieve step count from 
stack 
repeat if count not zero 
low order product 
to DE 
high order to HL 


RLD 
INX 
H 
RLD 
INX 
H 
RLD 
INX 
H 
RLD 
POP 
B 


DBNZ 
DCMPYI 
LDED 
PROD 


As the reader may have begun to guess, this is a very involved 
pro- 
cess which requires 
the execution 
of a great many more instructions 
than a binary 
multiplication. 
In addition, 
some of these instructions, 
particularly 
RRD and RLD, 
require 
considerable 
time to execute. 
The factors 
combine 
to make decimal multiplication 
almost glacially 
slow. If any significant 
amount 
of this must be done in a program 
it 
will pay the programmer 
to consider 
the alternative 
of converting 
the 
BCD to binary, 
performing 
the arithmetic 
in binary, 
then reconvert- 
ing the results to BCD. 
Decimal 
division 
is also made feasible by the existence 
of the four 
bit decimal 
shifts. 
It is performed 
in a manner 
analogous 
to binary 
division, 
with 
a check 
for divide 
fault 
followed 
by the successive 
shifting 
left of the dividend 
and subtraction 
of the divisor 
from the 
high dividend. 
The subtraction 
is not a one-time 
affair 
as in binary 
division, 
however. 
It must be continued 
until the result becomes 
neg- 
ative, a prezeroed 
quotient 
digit being incremented 
for each success- 
ful subtraction. 
This agony is presented 
for your inspection 
in exam- 
ple 11-8. 


An eight digit BCD dividend is in BC and HL, high order 
in BC, with a four digit BCD divisor in DE. Perform 
the 
indicated 
decimal 
division, 
returning 
the quotient 
in DE 
and the remainder 
in HL with carry off. If a divide fault 
occurs return with carryon. 


label 
ins!. 
operand 
DCDVD 
SHLD 
LDVDND 
save low dividend 
SBCD 
HDVDND 
and high dividend 
MOV 
A,C 
perform divide fault 
test 
SUB 
E 
subtract low orders 
DAA 
decimal adjust 
MOV 
A,B 
get high dividend 
SB8 
D 
form high difference 
DAA 
BNC 
DVDFLT 
if carry is off the high 
dividend was greater 
than or equal to the 
divisor and the divide is 
not possible 
MVI 
B,4 
divide step count to B 
D2 
LXI 
H,LDVDND 
low dividend address 
toHL 
ZAR 
clear A for decimal 
shift 


MOV 
C,A 
copy to C to clear 
quotient digit 
RLD 
shift low order 
INX 
H 
point to second order 
RLD 
shift second order 
INX 
H 
point to third order 
RLD 
shift third order 
INX 
H 
point to fourth order 


RLD 
shift fourth 
order 
DCX 
H 
move pointer 
back to 
beginning 
of high order 
dividend 
MOV 
A,M 
get lowest order high 
dividend 
D3 
SUB 
E 
subtract 
low divisor 
inE 
DAA 
decimal adjust 
PUSH 
PSW 
save on stack in case 
needed 
INX 
H 
point to highest order 
dividend 
MOV 
A,M 
fetch high two digits 
SBB 
D 
subtract 
high order 
DAA 
decimal adjust 
BC 
04 
if carry is on the 
difference 
was negative 
and the high divisor will 
remain 
unchanged, 
as if 
the subtraction 
had not 
taken place 
MOV 
M,A 
replace high order 
dividend 
DCX 
H 
point to third order 
dividend 
POP 
PSW 
retrieve third order 
dividend 
from stack 
MOV 
M,A 
and replace third order 
INR 
C 
increment 
quotient 
digit 
BRA 
03 
and do it again until the 
subtraction 
gives a neg- 
ative result 
04 
POP 
PSW 
restore 
stack pointer 
LOA 
LDVDNO 
get low dividend 
and 
merge 
ORA 
C 
new quotient 
digit into 


STA 
LDVDND 
DBNZ 
D2 


LHLD 
HDVDND 
LDED 
LDVDND 
RET 
DVDFLT 
STC 
RET 


the place vacated by the 
decimal left shift above 


and do it again if divide 
step count not yet 
exhausted 
clear carry for normal 
return 
remainder to HL 
quotient to DE 


Again, this process is very, very slow. Unless some compelling rea- 
son exists for staying with decimal, the reader is urged to consider 
conversion to binary for arithmetic of all kinds, with reconversion of 
the result for output. While the Z80's decimal arithmetic facilities 
are much better than those of any other existing microcomputer, 
they are still, in this writer's opinion, too primitive for serious use. 


If the reader is determined to use decimal arithmetic, 
a valuable 
exercise would be to explore the case in which the decimal divide of 
example 11-8 fails, namely when the highest BCD dividend digit is 
nonzero. If this is thoroughly studied out you will have achieved a 
significant understanding of the process. A clue to the answer is pro- 
vided in the earlier discussion of binary division. Good luck. Users 
of decimal arithmetic will need it, along with lots of patience and ex- 
tra memory. 


12 I 
COMMUNICATION 
WITH TERMINALS 


"He was so fast he could turn the light out 
and be in bed before the room got dark?' 


Description of "Cool Papa" Bell, 
baseball star of the old Negro Leagues 


A computer program ultimately derives its meaning from actions 
taken by it in response to promptings from the real world, those ac- 
tions, being communicated 
back to the real world in some form or 
other. The problem of coordinating the activity of the computer with 
that of the real world is made complicated by the great difference be- 
tween the internal speed of the computer and the speed of the real 
world devices with which it communicates. The computer is very fast 
indeed - 
perhaps not as fast as "Cool 
Papa" 
Bell in the above 
quote - 
but very fast. Keyboards and printers, on the other hand, 
are geared more to the speeds with which humans are comfortable, 
and therein lies the problem of coordination of the input/ output ac- 
tivity. It is the purpose of this chapter to detail how this coordination 
is achieved by programming. 
The chapter is by no means an exhaus- 
tive discussion of the input/output 
capabilities of the Z80, which 
would require a more extensive space. The information 
presented 
here will be enough to allow the beginning user to get started. Once 
these fundamentals 
have been mastered the reader can proceed to 
some of the more exotic data transfer modes available on the Z80. 
A peripheral device is connected to the computer by a controller 
known as an interface. This interface may be simple, forcing the 
program to perform most of the coordination 
work, or it may be 
complex as in the case of a disk, in which data transfer speeds are 
such that the computer would have difficulty keeping up with data 
transfer while performing all of the subsidiary housekeeping tasks. 
In either case the interface and the peripheral device are indistin- 


guishable to the program. All communication 
with the peripheral is 
done via the interface. 
The most fundamental 
function of the peripheral interface is to 
distinguish signals from the computer which are intended for it from 
those intended for another peripheral. 
This is done by the assign- 
ment of a unique number or numbers to each device, this number or 
numbers being known as the device address. This is not to be con- 
fused with a memory address. Memory is not involved in the transfer 
of data in the Z80, at least not in the modes we will consider here. 
There are three broad classes of operations performed by the com- 
puter in connection with input/ output operations. They are: 


1) Control functions. These involve a signal or signals sent from the 
computer to the peripheral interface to initiate some action. The 
functions vary from peripheral to peripheral. 


2) 
Sense functions. These involve interrogation 
of the interface by 
the computer to determine the status of an operation in progress. 
The commonest of the sense functions is a test to see whether the 
peripheral is busy or ready to transmit data. 


3) 
Data 
transfer. 
These 
operations 
move 
data 
between 
the 
computer and peripherals. Movement from the peripheral to the 
computer is known as input. Move of data from the computer to 
the peripheral is known as output. 


Perhaps the commonest of all peripheral devices is a terminal of 
some kind, either a teletypewriter or one of the many CRT devices 
available, and it is to the servicing of these devices that we will first 
turn our attention. 
In many ways a terminal device is one of the 
more complex peripherals the reader is likely to experience, involv- 
ing as it does both input from and output to the same physical de- 
vice. If the principles of programming 
for one of these devices are 
fully understood the reader should have no trouble transferring 
the 
knowledge to less complex devices. 
A terminal has two device addresses connected with it, usually but 
not necessarily adjacent numbers. These device addresses are known 
as the control or status port and the data port. Again, usually but 
not always, the control port has the lower address and the data port 


the next higher address. This will vary from system to system. What 
will be discussed here is the system used by the writer in the develop- 
ment of examples for this book. The reader should dearly under- 
stand that while the overall approach to the problem is general, the 
details of the process, e.g., which bit in the control port does what, 
will very likely be different in the system he uses. 
The writer's system has two terminal devices, a Teletype® connect- 
ed to control port 0 and data port 1, and a CRT device connected to 
control port 2016 and data port 2116• These devices are completely in- 
dependent. We will begin with the Teletype. In the absence of any 
other Teletype activity, a character can be printed on the Teletype 
printer by: 


MVI 
OUT 
A,'OJo' 
1 
percent sign to A 
send to Teletype data 
port 


This will print the percent sign (%) on the Teletype printer. This is 
simple enough if only the single character is to be printed. A compli- 
cation arises if a string of characters is to be printed, however. Since 
the Teletype requires about 
1/10 of a second to print each character 
sent to it, the computer must somehow arrange to pause between 
characters to allow the Teletype to process the character just sent be- 
fore sending another out. There are a number of ways of doing this 
of which the simplest is to build a time delay into the program. 
A 
subroutine which does this is shown in example 12-1. 


A subroutine to print the character in A on entry is re- 
quired. This subroutine should delay .1 second after the 
output and before returning to the calling program. 


label 
ODLAY 
inst. 
OUT 
operand 
1 
send character to 
Teletype data port 
a number is now loaded 


DCX 
MOV 
ORA 
BNZ 


B 
A,B 
C 
DLAYLP 


into BC which will de- 
pend on the speed of the 
system. BC will be 
decremented 
to zero, 
the count being tested 
after each decrement 
decrement 
B 
now test for zero 
both halves 
decrement 
again if not 
yet zero 


This scheme will work. 
The constant 
operand 
of the LXI 
can be experimentally 
adjusted 
to make the device run at 
maximum 
speed. 
The A, Band 
C registers 
as well as the 
flags are destroyed 
by this procedure, 
however. 
If they are 
to be returned 
unmolested, 
as is often the requirement, 
the 
routine 
must 
save 
and 
restore 
them. 
The 
routine 
then 
looks like this: 


label 
ODLAY 
inst. 
operand 
OUT 
1 


PUSH 
PSW 
PUSH 
B 
LXI 
B,(---) 
DCX 
B 
MOV 
A,B 
ORA 
C 
BNZ 
DLAYLP 
POP 
B 
POP 
PSW 
RET 


send character 
to 
Teletype, 
as before 
saveAF 
saveBC 
count to BC 
count down, as before 


restore 
BC 
restore AF 


If the system is sufficiently fast, the capacity of Be may 
not be sufficient to delay .1 second by merely counting. A 
more elaborate delay scheme must then be devised. 


Using the subroutine of example 12-1 a string of characters may 
be printed by successive calls. The name LISA could be printed by: 


MVI 
A,'L' 
CALL 
ODLAY 
MVI 
A,'I' 
CALL 
ODLAY 
MVI 
A,'S' 
CALL 
ODLAY 
MVI 
A,'A' 
CALL 
ODLAY 


This scheme would work, but it is clumsy, and would have to be 
reprogrammed if a terminal of different speed were substituted, e.g., 
one of the many 30 character per second devices now available. 
A better way is to use the built in delay facilities of the interface to 
sense the terminal's 
readiness 
to accept another 
character. 
The 
busy/not busy status of the terminal is recorded in the bits of the 
control/status 
word. In the writer's system the leftmost bit of the 
control/status 
word is the busy/not busy indicator for Teletype out- 
put. This bit is a one if the a character is being printed and a zero if 
no activity is in progress, Le., if the Teletype is ready to accept an- 
other character. The contents of the control/status 
port are loaded 
into the A register by: 


The use of the status bits in the control/status 
word for output is 
shown in example 12-2. 


A subroutine 
is required 
to print the character 
in A on en- 
try. Use the method 
just outlined. 
All registers 
should 
re- 
turn unchanged. 


label 
inst. 
operand 
TTYOUT 
OUT 
TTYDTA 
send character 
to TTY 
data port 
PUSH PSW 
saveAF 
TTYOT2 
IN 
TTYCTL 
read control 
word 
RAL 
rotate leftmost 
bit into 
carry 
BC 
TTYOT2 
if carry is still a one the 
character 
is still being 
processed 
by the Tele- 


type. Branch back and 
wait 
POP 
PSW 
retrieve AF 
RET 
return 
to calling 
program 
TTYCTL 
EQU 
0 
define TTY control! 
status port 
TTYDTA 
EQU 
TTYCTL+l 
define TTY data port 


This subroutine 
can be used to print 
a string of characters 
in the 
same 
W(;lY 
as was shown 
immediately 
following 
example 
12-1. A 
more convenient 
way to print the string is shown in example 
12-3. 


Using the TTYOUT routine 
of example 
12-2, write a sub- 
routine 
to print a string of characters. 
The address 
of the 
first character 
to be printed 
is in HL and the number 
of 
characters 
in the string is in B. 


label 
PSTRG 
inst. 
operand 
MOV 
A,M 
CALL TTYOUT 
INX 
H 
DBNZ PSTRG 


get first character 
print it 
increment pointer 
decrement count and 
repeat 
finished, return to 
calling program 


LXI 
H,BRMSGE address of BEER 
message to HL 
MVI 
B,LST+I-BRMSGE 
character count to B 
CALL 
PSTRG 
call the string print 
routine 


BRMSGE 
ASC 
'WHO DRANK MY BEER' 
LST 
DATA '?' 


Very often it is inconvenient to specify a number of characters to 
be printed. Another scheme is to choose some special character as a 
message terminator. 
The string print routine prints characters until 
the 
agreed 
upon 
termination 
character 
is encountered 
in the 
string. Control is then returned to the calling program. The termina- 
tion character 
itself is not printed. 
Such a string print routine is 
shown in example 12-4. 


A string print subroutine is required which will accept the 
address of the first character to be printed in HL. The suc- 
cessive characters of the string are to be printed until a car- 
riage return code (8DI6) is encountered. 
At this point re- 
turn control to the calling program. Do not output the car- 
riage return. 


label 
inst. 
operand 
PRT 
MOV 
A,M 
get message character 
CPI 
:8D 
check for carriage 
return 
REQ 
return if equal 
CALL 
TTYOUT 
otherwise print the 
character 
INX 
H 
increment the pointer 
BRA 
PRT 
and do it again 


This form has the advantage that the number of characters 
to be printed need not be specified. The message is of the 
form: 


ASC 
DATA 
'DARTH VADER IS A GOOD GUY!!' 
:8D 


address of first message 
character to HL 


To emphasize the difference between different terminal devices, 
and to underscore that the input/output 
illustrations given here are 


specific to the writer's 
system, the equivalent 
sequence to TTYOUT 
is given here for the CRT terminal attached to the same system. 


CRTOUT 
OUT 
CRTDTA 
output to CRT data 
port 
PUSH PSW 
saveAF 
CRTOT2 
IN 
CRTCTL 
read control/status 
word 
RAR 
move low bit to carry 
RAR 
move next to low bit to 
carry 
BNC 
CRTOT2 
skip if flag bit still zero 
POP 
PSW 
return to calling 
RET 
program 
CRTDTA 
EQU 
:20 
CRTCTL 
EQU 
CRTDTA+l 


Notice first that the busy flag for the CRT terminal is the second bit 
from the right, rather than the leftmost bit as for the Teletype. No- 
tice also that the ready condition for the CRT is one, rather than the 
zero used with the Teletype. The reader must understand 
that these 
routines are purely illustrative 
and specific to a single system. They 
must be modified as indicated for use with different hardware. 
Before leaving the subject of output to terminal 
devices a couple 
of things should be noted. First, the busy/not 
busy status of the out- 
put machinery 
is indicated 
by the zero or one status of a bit in the 
control/status 
word. The ready condition 
may be either zero or one 
depending on the specific interface device being used and system wir- 
ing. Second, the status of the output machinery will always be ready 
when it is not in use. This is of no importance 
now but will loom 
large when we come to the subject of output under interrupt 
control. 


Input from a keyboard 
attached 
to a terminal 
is pretty much the 
inverse of output. 
The status of the input machinery is not ready un- 


til a key is struck. When the key is struck the flag indicates the ready 
state and the program 
may proceed to read the data port. This pro- 
cess is shown for Teletype in example 12-5. 


The input ready bit is the rightmost bit of the Teletype 
control/status 
word. It is one in the not ready state and be- 
comes zero when a key is struck. Write an instruction to 
read a character from the keyboard. 


label 
inst. 
operand 
Rl 
IN 
TTYCTL 
read control word 
RAR 
rightmost bit to carry. 
If this bit is a one no 
key has been struck 
BC 
Rl 
loop back until ready 
IN 
TTYDTA 
ready, read the 
character 


To again emphasize that each device is different, 
the input se- 
quence for the CRT terminal in the writer's system is given below. 


CRTR 
IN 
RAR 
read CRT control word 
rightmost bit to carry. 
This, by pure coin- 
cidence, is the same as 
for the Teletype in ex- 
ample 12-5 
this time the test for 
ready is for a one, not a 
zero as for the Teletype 
ready, read the 
character 


A terminal keyboard resembles a typewriter keyboard in its super- 
ficial characteristics, 
but there are some important 
differences. The 
most important of these is that striking a key does not automatically 


cause the character 
represented by that key to be printed on the 
printer or appear on the CRT screen. If this is to be done the pro- 
gram must supply the instructions to "echo" 
the character back to 
the terminal. Further, unlike a typewriter, a terminal device does not 
automatically 
advance one line when a carriage return code is sent 
out. The line advance, or line feed, is a separate function. Finally, 
the highest bit of a character received from the keyboard varies from 
device to device. It may be wired to be always a one or always a zero, 
or, it may be used to indicate the even or odd parity of the character 
as a check against errors in transmission. A blank may be represent- 
ed by either 0010ססoo2 or 1010ססoo2. To avoid having to check both 
cases some convention is adopted and the highest bit is forced to 
either zero or one. The high bit may be forced to zero by: 


One or the other of these conventions must be used. The examples in 
this book and the software in the appendices assume that the highest 
bit is forced to one. A Teletype keyboard service subroutine which 
performs automatic line feeds and forces the high bit of the received 
character to one is shown in example 12-6. 


Write a Teletype keyboard service routine which forces the 
high bit of the typed character to one, and "echos" 
the 
typed character back to the Teletype printer. When a car- 
riage return is received the line feed code (8A16) should be 
supplied automatically. 
The return in this last case should 
be with the carriage return code, not the line feed. The 
typed character is to be returned to the calling program in 
the A register. 


label 
ins!. 
operand 
RKB 
IN 
TTYCTL 
get TrY control word 
RAR 
low bit to carry 
BC 
RKB 
loop until ready 
IN 
TrYDTA 
ready read typed 
character 
ORI 
:80 
force high bit to one 
PUSH 
PSW 
save character 
RKBl 
OUT 
TTYDTA 
send character to 
printer 
RKB2 
IN 
TTYCTL 
get control word again 
RAL 
leftmost bit to carry 
BC 
RKB2 
loop until character 
clears 
POP 
PSW 
restore AF 
CPI 
:8D 
was character just typed 
a carriage return? 
RNE 
return if not 
MVI 
A,:8A 
otherwise supply line 
feed code 
OUT 
TTYDTA 
send it out 
RKB3 
IN 
TrYCTL 
read status, as before 
RAL 
BC 
RKB 
loop until line feed 
clears 
MVI 
A,:8D 
reload carriage return 
code 
RET 
and return 


The Teletype sequences given in this chapter are standard TTY se- 
quences and device addresses for ALTAIR and IMSAI based ma- 
chines. If the reader is using any other system the location of the rea- 
dy bits and their one or zero status will, in general, be different. 
Consult the manufacturer's 
literature for the exact information 
for 
your system. 


Another facet of terminal communication 
is the initialization 
of 
the terminal interface. There is no such thing as a standard initializa- 
tion sequence. This sequence is necessary to set data rates and other 
parameters peculiar to each device. Again, consult the literature of 
the manufacturer 
of your system for specific details. 
The 
Z80 is capable 
of performing 
intput/ output 
operations 
through registers other than A and in modes other than those already 
illustrated in this chapter. In particular, if the name of a single regis- 
ter is appended to the mnemonic like this: 


a different sort of operation is performed. The device address in this 
case is presumed to be in the C register and the input! output opera- 
tion is performed between this device address and the register named 
in the instruction mnemonic. Input is done by attaching any of the 
register names A, B, C, D, E, H, or L to the IN mnemonic. Output 
instruction are of the form: 


OTA 
OTH 


etc. Again the device address is presumed to be in the C register, the 
data from the machine register (A or H in this case) going to that de- 
vice address. 


Even more elegant input/output 
modes are available using the 
IN+, 
IN-, OUT+ and OUT- instructions. 
In this mode a count of 
the number of words to be transferred is kept in B and address of the 
first word of the block to be transferred in HL, with the device ad- 
dress in C. After each transfer the B count is decremented and HL is 
incremented 
or decremented, 
according to whether the mnemonic 
ended with + or -. The flags are set to show the condition of B after 
the decrementation. 
Finally, there are the IN+R, 
IN-R, 
OT+R 
and OT-R instruc- 
tions, which are the repeating counterparts 
of the instructions just 
discussed. They allow very high speed transfer of up to 256 words of 
data. This is useful when communicating with fast devices like disks. 


ASCIICODES 


Character Hexadecimal Code 
Character 
Hexadecimal Code 
@ 
CO 
blank 
AO 
A 
CI 
! 
Al 
B 
C2 
" 
A2 
C 
C3 
# 
A3 
D 
C4 
$ 
A4 
E 
C5 
070 
A5 
F 
C6 
& 
A6 
G 
C7 
A7 
H 
C8 
( 
A8 
I 
C9 
) 
A9 
J 
CA 
* 
AA 
K 
CB 
+ 
AB 
L 
CC 
AC 
M 
CD 
AD 
N 
CE 
AE 
0 
CF 
/ 
AF 
p 
DO 
o (zero) 
BO 
Q 
DI 
I 
BI 
R 
D2 
2 
B2 
S 
D3 
3 
B3 
T 
D4 
4 
B4 
U 
D5 
5 
B5 
V 
D6 
6 
B6 
W 
D7 
7 
B7 
X 
D8 
8 
B8 
Y 
D9 
9 
B9 
Z 
DA 
BA 
[ 
DB 
BB 
\ 
DC 
< 
BC 
] 
DD 
BD 
t 
DE 
> 
BE 
DF 
? 
BF 


The following codes print nothing but perform the indicated func- 
tions. 


87 
ring bell 
8D 
return carriage 
8A 
line feed 


FF 
rubout 
00 
null 


13 I 
NUMBER BASE 
CONVERSIONS 


Meet General Grant 
William E. Woodward 


A computer 
engaged in any task other than pure digital meditation 
must eventually 
deal with the real world, 
taking 
data from it and re- 
porting 
answers 
to it. Since the computer 
must deal with creatures 
who are captives 
of a ten fingered 
anatomy, 
the programmer 
is re- 
quired 
to know how to convert 
between 
the internal 
binary 
system 
and the external 
real world system, usually decimal. 
Systems for conversion 
between binary 
and decimal 
rely upon the 
fact that the coded representation 
of a decimal 
digit contains 
some- 
where in it the equivalent 
binary 
quantity. 
Look for a moment 
at the 
ASCII codes for the decimal digits 0 - 9. 


decimal digit 
o 
1 
2 
3 
4 
5 
6 
7 
8 
9 


ASCII code 
1011 
0000 
1011 
0001 
1011 
0010 
1011 
0011 
1011 
0100 
1011 
0101 
1011 
0110 
1011 
0111 
1011 
1000 
1011 
1001 


The ASCII 
codes have been deliberately 
split into four bit groups 
for easy examination. 
The upper four bits of the codes are identical. 


The lower four bits are simply the BCD representation 
of the digit. 


If the upper 
four bits can be gotten 
rid of somehow, 
the remaining 


BCD will be easy to deal with. This can be done easily with the AND 
function. 
This operation 
and 
another 
important 
operation 
are 
shown in example 13-1. 


A subroutine is required which will determine whether the 
character in A on entry is valid numeric, i.e., whether it 
lies in the B016 through 
B916 range. 
If the character 
is 
numeric mask out the upper four bits, returning with the 
resulting BCD in A and carry off. If the character is not 
valid numeric leave it unchanged and return with carryon. 


label 
ins!. 
operand 
NCHK 
CPI 
:BO 
BLS 
NON 


CPI 
:BA 
BGE 
NON 


check low limit 
non-numeric if less than 
B016 
check high limit 
no good if greater than 
or equal to BA16• The 
test is made for one 
greater than the actual 
upper limit, B916, 
because the Z80 has no 
test for greater than, 
only greater than or 
equal to. If control gets 
past here the character 
was valid numeric 
clear upper four bits 
and carry 
return to calling 
program 
carryon for error 
return 
return to calling 
program 


The importance 
of the validity check in example 13-1 cannot be 
overstressed. The incoming data originate in some real world source 
which is subject to error, and if a finger slips while typing the conse- 
quences to the outcome of a program cannot be foreseen. All input, 
from any source, must be checked for validity and appropriateness. 
It is much better for the program to take a moment to ask the opera- 
tor if he really means this than to have a mistake allow a process be- 
ing controlled to run wild. 
Now that we have a means of assurance of valid incoming data we 
can proceed with the conversion of the incoming number to binary. 
The simplest of all possible conversions is from decimal integer to bi- 
nary integer. This is done by clearing a result area to zero and per- 
forming the following steps: 


a) get a digit and verify its validity 
b) multiply the previous result by ten 
c) add the BCD digit to the binary result 
d) start over with step a above 


The multiplication by ten is simple, being done by the shift and add 
process shown in chapter 8. A single precision conversion of this 
type is shown in 'example 13-2. 


Using the RKB routine 
of chapter 
12 and the validity 
check routine of example 13-1, create a subroutine which 
will convert a decimal number typed at the keyboard. The 
result should be returned in B. Conversion should cease 
when a non-numeric 
character is typed, and control re- 
turned to the calling program 
with the character which 
caused termination in A. 


label 
SCON 
SCt 


ins!. 
MVI 
CALL 


operand 
B,O 
RKB 
clear result register 
get character from 
keyboard 


CALL 
NCHK 
check it for validity 
RC 
NCHK returns with 
carryon if the character 
was non-numeric 
MOV 
C,A 
save typed, stripped 
BCD digit 
MOV 
A,B 
get previous result 
LLA 
shift left 
MOV 
B,A 
save 
LLA 
shift left again 
LLA 
and again 
ADD 
B 
former result times 10 
ADD 
C 
add new digit 
MOV 
B,A 
save new result 
BRA 
SCt 
and get another digit 


The program in example 13-2 will convert successive typed digits 
to a binary number - 
if there are not too many of them. The prob- 
lem is that there is no check for the overflow of the result, i.e., the 
decimal number 256 would return as zero, the only significant bit be- 
ing the ninth bit - 
which was shifted out. The remedy for this would 
be to check carry after each shift. If carry were a one after any shift 
the result overflowed. 
An eight bit convert is not a very useful program, 
however. The 
extreme shortness of the Z80 word does us no good here. A practical 
converter would need to handle 16 bit numbers at least. Such a con- 
verter, with check for overflow, is shown in example 13-3. 


A subroutine is required to convert a series of typed digits 
to a 16bit binary integer. The calling sequence for the sub- 
routine is to look like this: 


label 
inst. 
operand 
CALL 
CNV16 
call converter 
BRA 
DSASTR 
return here if result 
overflowed 
return here if result 
valid 


Return is to be made with the binary result in HL and the 
character which caused termination in A. 


CNV16 
LXI 
H,O 
clear result area 
MOV 
B,H 
and upper addend for 
new digit 
CNV16A CALL 
RKB 
get character from 
keyboard 
CALL 
NCHK 
check for numeric 
validity 
BC 
EOCNV 
skip if not numeric 
DAD 
H 
shift HL left 
RC 
check for overflow 
MOV 
D,H 
save shifted number 
MOV 
E,L 
DAD 
H 
shift again 
RC 
check for overflow 
DAD 
H 
shift again 
RC 
check for overflow 
DAD 
D 
add twice the original 
number 
RC 
check again for 
overflow 
MOV 
C,A 
move new digit to C. 
BC will be added to 
HL. Note that B has 
already been set to zero 
above 
DAD 
B 
add new BCD digit 
RC 
check for overflow 


BRA 
CNV16A 
and do it again 
EOCNV 
XTHL 
swap result with return 
pointer 
at top of stack 
INX 
H 
bump return 
pointer 
twice 
INX 
H 
to skip over BRA 
instruction 
XTHL 
reswap 
RET 
and return 
to calling 
program 


In some cases 16 bits will not be enough 
and it will be necessary 
to 
go to even greater precision. 
This operation 
involves the same princi- 
ples as shown for single and double 
precision. 
The exact mechanics 
of such a conversion 
becomes 
a little more involved 
and tedious, 
as 
one might 
expect. 
A quadruple 
precision 
decimal 
to binary 
conver- 
sion is shown in example 
13-4. This will convert 
a number 
as large as 
4,294,967,303. 
A need for greater 
precision 
than this is seldom seen. 


A quadruple 
precision 
decimal 
to binary 
convert 
subrou- 
tine is required 
which will accept input from the keyboard 
and return 
the high order 
result 
in DE, the low order 
in 
HL. Normal 
return 
should 
skip the two word instruction 
following 
the CALL. 
If overflow 
occurs return 
to the in- 
struction 
immediately 
following 
the CALL. 


label 
inst. 
operand 
QCON 
LXI 
H,O 
MOV 
n,H 
MOV 
E,H 
QCl 
CALL 
RKB 


CALL 
NCHK 
check validity 
BC 
EOQC 
skip out if not numeric 
CALL 
DLSHF 
the shifting 
is relegated 
to a subroutine 
because 
it will be done 3 times 
SDED 
HI 
save intermediate 
result 
SHLD 
LO 
CALL 
DLSHF 
shift again 
CALL 
DLSHF 
twice 
LBCD 
LO 
now add saved quantity 
DAD 
B 
XCHG 
LBCD 
HI 
high order add 
DAC 
B 
add high orders, 
propagate 
carry 
RC 
if there was a carry here 
the result is too big to 
be held 
XCHG 
low order to HL again 
MOV 
C,A 
new digit to C 
MVI 
B,O 
clear B for double add 
DAD 
B 
add new digit, low 
order 
BNC 
QCl 
if there is no carry here 
we can proceed with the 
next digit, otherwise 
INR 
E 
increment 
high order. 
Here we have the prob- 
lem again that INR 
does not set carry. 
It 
does set the zero bit, 
however, 
and the only 
condition 
under which a 
carry would be gener- 
ated by incrementing 
would be if the original 
number 
were FF16, 


which is incremented to 
00. Testing the zero flag 
will therefore amount 
to the same thing as 
testing carry 
BNZ 
QCl 
skip if no carry 
INR 
D 
increment highest order 
BNZ 
QCl 
skip back if no carry 
RET 
if it gets here the 
converted number is too 
big to be held. Return 
to location immediately 
after CALL 
DLSHF 
DAD 
H 
shift low order left 


-XCHG 
swap for high order 
DAC 
H 
shift high order, 
propagate carry 
XCHG 
reswap 
RNC 
return if no carry. If 
there is a carry here the 
number overflowed 32 
bits 
INX 
SP 
the return to the calling 
program is a little com- 
plicated by the fact that 
the last item pushed on- 
to the stack was not the 
return address for 
QCON but the return 
address for DLSHF. 
This is remedied by sim- 
ply incrementing SP 
over the DLSHF return 
address to 
INX 
SP 
the QCON return 
address 
RET 
take error return 


EOQC 
XTHL 
swap HL with top of 
stack 
INX 
H 
increment return 
address over error 
INX 
H 
return 
XTHL 
reswap 
RET 
take normal return 


Conversion of decimal fractions to binary fractions begins by con- 
verting the successive digits as an integer, then dividing by ten a num- 
ber of times equal to the number of decimal digits which appeared to 
the right of the point. This division is performed by using the highest 
order of the preliminary integer result as the low order dividend and 
zero as the high order dividend. With ten as the divisor this is guar- 
anteed to be divisible. The quotient of this division is the high order 
quotient. The remainder forms the high order divisor for the next 
stage division, the low order divisor being the next order of the pre- 
liminary integer result. This is repeated until all of the integer orders 
have been divided, the successive quotients replacing the integer re- 
sult. This entire process is repeated as many times as there were dig- 
its to the right of the point. 
Note before leaving this fraction question that there are decimal 
fractions which cannot be exactly represented in binary, just as some 
fractions cannot be represented in decimal, e.g., 1/3, 1/7, 1/9 etc. In 
particular the decimal fraction 0.1 is represented in binary by: 


Le., it is a repeating fraction. If this is converted to decimal the re- 
sult is .099984741, approximately. 
Conversion of binary integers to decimal is also a fairly straight- 
forward process. There are two principal methods that can be used. 
The first is to divide the integer by ten, each successive division yield- 
ing a remainder. The first remainder is the BCD low order digit. The 
quotient from this division is then again divided by ten. This remain- 


der is the BCD tens digit. The quotient at each stage is divided by ten 
to yield the next higher order BCD digit as a remainder. This process 
continues until the quotient is zero. A conversion of this type is 
shown in example 13-5. 


Using the division scheme of example 8-9 and the Teletype 
output subroutine of example 12-2, create a subroutine to 
convert the unsigned binary integer in A to decimal. Print 
the decimal result on the Teletype. The program in exam- 
ple 8-9 is made into a subroutine by simply adding an RET 
to the end. It now looks like this: 


label 
DVD 


DVD2 
DVD3 


ins!. 
operand 
MOV 
A,H 
commentary as for 
example 8-9 
ORA 
A 
JM 
DVDFLT 
CMP 
D 
BGE 
DVDFLT 
MVI 
B,8 
MVI 
E,O 
DAD 
H 
DSC 
D 
BC 
DVD2 
INX 
H 
BRA 
DVD3 
DAD 
D 
DBNZ 
DVDl 
RSC 
RET 
STC 
RET 


carry off for normal 
return 
carryon for divide fault 
return 


the example which follows that it was not necessary to in- 
clude the divide fault check, since no divide fault condi- 
tion can arise, by the conditions of the problem. To create 
a divide routine without this check would sooner or later 
lead to a catastrophe when the routine was used by anoth- 
er program which did not guarantee against divide fault. 


move number to be 
converted to L 
clear upper dividend 
set divisor to 10. Since 
the high dividend is 
zero and the divisor 10 
no divide fault can 
occur 
perform the division. 
The remainder from 
this division in H is the 
low order digit. We 
can't print this now 
since printing goes from 
left to right and the two 
higher order digits have 
to be printed first. The 
easiest way to save it is 
to push it onto the 
stack 
save low order (units) 
digit 
again clear high 
dividend. The quotient 
from the first division, 
still in L, will be the low 
dividend for the next 
division 


MVI 
MVI 
H,O 
D,lO 


CALL 
DVD 
divide again. The 
remainder 
in H is the 
tens digit. The quotient 
in L is the hundreds 
digit since an eight bit 
number cannot have a 
value greater than 25510 
MOV 
A,L 
hundreds digit to A 
ORI 
:BO 
form ASCII 
CALL 
TTYOUT 
print hundreds 
digit 
MOV 
A,H 
tens digit to A 
om 
:BO 
form ASCII 
CALL 
TTYOUT 
print tens digit 
POP 
PSW 
recall that the units 
digit was saved by push- 
ing HL onto the stack. 
The BCD digit was in 
H, the higher order reg- 
ister. Popping the for- 
mer HL contents into 
AF puts the former con- 
tents of H into A (Re- 
member A is the high 
order register of the 
AF pair) 
om 
:BO 
form ASCII 
CALL 
TTYOUT 
print units digit 


The essential awkwardness 
of the method of example 13-5 is that 
the digits are produced 
in the opposite order from that in which they 
are required 
for printing. 
This could be solved by pushing each gen- 
erated digit in a long conversion 
onto the stack, allowing them to be 
retrieved in the opposite order from that in which they were pushed, 
Le., the correct order for printing. 
Still, this wastes stack space and 
is clumsy. There is a better way which will produce the digits in the 


order required for printing. This method involves starting with the 
highest possible decimal power, subtracting 
that power from the 
number to be converted until the result is negative. The number of 
successful subtractions, 
i.e. subtractions which did not have a nega- 
tive result, is the high BCD digit. This power of ten is then added 
back into the number to give the value before the terminating sub- 
traction. The next lower power of ten is then successively subtracted 
from the remaining number until it goes negative. The number of 
successful subtractions is the BCD digit at that decimal position. The 
power of ten is then added back in to make the number positive and 
the entire process is repeated until the units digit is reached. This 
sounds more tedious than it really is. The process is shown in exam- 
ple 13-6. 


Example 13-6 


Write an instruction 
sequence which will convert the un- 
signed eight bit number in A by the subtraction 
method 
just described and print it using the TTYOUT subroutine. 


label 
ins/. 
operand 
MVI 
B,:BO 
ASCII zero to B. This 
could as well have been 
written: MVI 
B,'O' 
Cl 
SUI 
100 
subtract 100's till it goes 
negative 
BC 
C2 
carryon means zero 
was crossed 
INR 
B 
increment ASCII digit 
inB 
BRA 
Cl 
and subtract again 
C2 
ADI 
100 
add the last 100 back in 
PUSH 
PSW 
save number 
MOV 
A,B 
get generated ASCII 
digit 
CALL 
TTYOUT 
print high order digit 
MVI 
B,:BO 
ASCII zero to B 


POP 
PSW 
retrieve number from 
stack 
C3 
SUI 
10 
subtract 10till it goes 
negative 
BC 
C4 
INR 
B 
increment ASCII digit 
as before 
BRA 
C3 
C4 
ADI 
10 
add the last 10 back in 
PUSH 
PSW 
save remaining BCD 
units digit 
MOV 
A,B 
get tens digit from B 
CALL 
TTYOUT 
print it 
POP 
PSW 
retrieve BCD units digit 
ORI 
:BO 
merge with ASCII code 
bits 
CALL 
TTYOUT 
print units digit 


The more experienced programmer 
will notice an economy that 
could have been made here. The line: 


which would have allowed the removal of the om 
:BO in the sec- 
ond to the last line. Think about it. 


Double precision and signed conversions involve the same meth- 
ods as have been shown. A requirement which often arises is elim- 
ination of leading nonsignificant zero digits, the leading zeros being 
replaced by blank or some other character, Le., the converted num- 
ber should print like this: 


In commercial 
applications 
particularly, 
numbers 
representing 
mon- 
ey often 
have 
leading 
zeros 
replaced 
with 
asterisks 
so that 
the 
amount 
cannot 
be changed, 
like this: 


A subroutine 
is required 
which will convert 
the 16 bit un- 
signed 
magnitude 
in HL 
to a five digit 
decimal 
ASCII 
number, 
leaving this result in the block of five memory 
lo- 
cations 
beginning 
at the address 
pointed 
to by X. Leading 
nonsignificant 
zeros should be replaced 
by blanks. 


label 
inst. 
operand 
DCNV 
MVI 
C,' 
ASCII blank to C 
MVI 
D,5 
decimal digit count to B 
LXI 
Y,PTDL 
address 
of powers of 
ten table to Y 
DCNVl 
LEY 
0 
low order power of ten 
toE 
INX 
Y 
increment 
power table 
pointer 
LDY 
0 
high order power of ten 
toD 
INX 
Y 
increment 
for next pass 
ZAR 
clear A for decimal 
result 
DCNV2 
DSC 
D 
subtract 
power of ten 
from number 
DC 
DCNV3 
carry if zero was 


INR 
A 
BRA 
DCNV2 
DCNV3 
DAD 
D 
ORA 
A 
BZ 
DCNV4 
MVI 
C,'O' 


DCNV4 
ORA 
C 


SAX 
INX 
DBNZ 


o 
X 
DCNVl 


crossed 
increment 
BCD digit 
and do it again 
restore number 
was the digit zero? 


no, replace the filler 
character 
with an 
ASCII zero 
if any nonzero 
BCD 
digit has been generat- 
ed, the ASCII blank in 
C has been replaced 
by 
ASCII zero. If the 
blank is still there, it 
will be ORed with zero 
to give a blank. 
All 
leading zero digits are 
made blank by this 
method 
store character 
in string 
increment 
store pointer 
decrement 
count and 
try again. When the 
count goes to zero the 
conversion 
is finished 
except for one small 
detail. 
If the original 
number 
was all zero, 
there were four leading 
nonsignificant 
zeros 
converted, 
i.e. no nu- 
meric digits have been 
stored, 
only blanks. 
There must be at least 
one numeric 
digit 
displayed. 
We insure 


that this is so by: 
retrieve last character. 
Since X was already in- 
cremented before the 
DBNZ 
was 
executed, 
we 
use a displacement of 
-1 here to retrieve it 
force the last character 
numeric 
and put it back in the 
stored string 


DBL 
DBL 
DBL 
DBL 
DBL 


10000 
1000 
100 
10 
1 


The program of example 13-7 could have been made somewhat 
faster by making a special case of the units digit. After the last ten 
has been subtracted from the number the remaining number is, by 
definition, less than ten, i.e., it is the BCD units digit. Counting 
down again by subtracting one and adding one to the counter in A 
wastes time but avoids making a special case of the units digit, sav- 
ing program space. Since conversion is done as part of the output 
process, the speed at which things happen will be determined by the 
speed of the peripheral receiving the information, hundreds of times 
slower than the rate at which the computer can generate it, so it was 
judged here better to save space rather than time. 
Conversion of signed numbers is a little more difficult. Note is 
made of the algebraic sign of the number, and then it is forced posi- 
tive, the conversion taking place on the positive number and the ap- 


propriate 
ASCII 
sign being attached. 
This process is shown in exam- 
ple 13-8. Note that this subroutine 
makes no special provision 
for the 
maximum 
negative 
number, 
which cannot 
be two's 
complemented, 
yet it converts 
this number 
correctly. 
Example 
13-8 should be studied 
until you understand 
why this takes place. 


A signed 16 bit number 
is in HL. A subroutine 
is required 
which will convert 
it to ASCII 
decimal, 
leaving the result 
in the six word block pointed 
to by X. The algebraic 
sign 
should be placed immediately 
to the left of the highest sig- 
nificant 
digit, and all leading 
nonsignificant 
zeros should 
be replaced 
by blanks. 


label 
ins!. 
operand 
SDCNV 
MVI 
B,'+' 
ZAR 


ORA 
H 
JP 
SDCNV2 
MVI 
B '-', 
MOV 
A,H 


CMA 
MOV 
H,A 
MOV 
A,L 
CMA 
MOV 
L,A 
INX 
H 


SDCNV2 
LXI 
Y,PTBL 


INX 
X 


ASCII plus sign to B 
clear A to determine 
sign 
high order binary to A 
skip if positive 
ASCII minus sign to B 
now two's complement 
the number 


if overflow 
occurs here 
the negation 
was illegal, 


but we ignore it. Why? 
address 
of powers of 
ten table to Y 
this makes the character 
store pointer 
point to 
the second of the six 


words. 
There can be on- 
ly five numeric 
dIgits. 


The sixth space must 
hold either a blank or 
the algebraic 
sign 
MOV 
A,B 
ASCII sign to A 
XAF 
save it in A' 
MVI 
B,5 
digit count to B 
MVI 
C,' 
ASCII blank to C 
SCX 
-1 
this stores the blank in 
C into the first word of 
the string. Since X had 
already 
been increment- 
ed the negative 
dis- 
placement 
was 
necessary 
SDCNV3 
LEY 
0 
low order power of ten 
toE 
INX 
Y 
increment 
pointer 
LDY 
0 
high order power of ten 
toD 
INX 
Y 
increment 
pointer 
ZAR 
clear A to receive result 
digit 
SDCNV4 
DSC 
D 
subtract 
power of ten 
JM 
SDCNV5 
skip if it went negative 
INR 
A 
otherwise 
increment 
digit in A 
BRA 
SDCNV4 
and do it again 
SDCNV5 
DAD 
D 
restore 
number 
ORA 
A 
test digit for zero 
BZ 
SDCNV7 
skip if zero 
MVI 
C,'O' 
otherwise 
replace the 
blank in C with an 
ASCII zero 
XAF 
and see if the sign has 
already 
been placed in 


HZ 
SDCNV6 
SAX 
-1 


SDCNV6 
SDCNV7 
XAF 
ORA 
C 


SAX 
0 
INX 
X 
DHNZ 
SDCNV3 
LAX 
-1 


SAX 
-1 
RET 


the string 
if it has been zeroed the 
sign is already 
in place 
yes, it has 
no it hasn't. 
Place the 
sign in the word imme- 
diately preceding 
the 
address where the cur- 
rent digit will be placed 
and clear the ASCII 
sign 
restore the digit 
OR with blank or 
ASCII zero 
place digit in string 
increment 
for next digit 
and get next digit 
make sure we have at 
least one 
significant 
numeric 
digit 
as before 
finished, 
return to 
calling program 


The table of powers of ten is exactly as it appears 
in exam- 
ple 13-7. 


Conversion 
of binary 
fractions 
to decimal 
is much 
easier. 
The 
fraction 
is multiplied 
by ten, yielding 
an integer 
digit. This integer 
digit is the highest 
order 
decimal 
digit of the fraction. 
The integer 
digit is cleared 
and the remaining 
fraction 
again multiplied 
by ten, 
yielding another 
integer digit. This integer digit is the second decimal 
fraction 
digit. 
This process 
is carried 
on for as many 
places 
as re- 
quired 
or until the fraction 
becomes 
zero. To see this clearly, 
consid- 
er a double 
precision 
number 
with the point 
between 
the halves 
of 
the number, 
Le., with scale factor 8: 


Treating 
this as a pure binary 
integer 
its value would be 192. Multi- 
plying this number 
by ten gives: 


The high order part of the number 
is a BCD 7, the high decimal digit. 


This integer is cleared to give: 


The integer 
part 
of the product 
is a BCD 5, the second 
digit. 
The 
fraction 
has now become 
zero, so there is no more conversion 
to be 
done. The digits 7 and 5 are the decimal representation 
of the binary 
fraction 
.1100ססoo. 
A conversion 
of this type is shown in single precision 
in example 
13-9. 


A subroutine 
is required 
which will convert 
and print the 
eight 
bit binary 
fraction 
in A on entry. 
The conversion 
should 
end when there are no more significant 
digits to be 
generated, 
i.e., 
when the fraction 
becomes 
zero. 
Print 
a 
decimal point ahead of the decimal fraction. 


label 
SFC 
ins!. 
MOV 
operand 
L,A 
save original 
fraction 
in 
L 
ASCII point to A 
print the point 
clear upper product 


MV} 
CALL 
MV} 


A, 
, 
,. 
TIYOUT 
H,O 


DAD 
H 
shift left once 
MOV 
C,L 
save shifted number 
MOV 
B,H 
DAD 
H 
shift twice more 
DAD 
H 
DAD 
B 
form final product, HL 
times ten 
MVI 
A,'O' 
ASCII zero to A 
ORA 
H 
merge BCD integer with 
ASCII digit frame 
CALL 
TTYOUT 
print the digit 
MOV 
A,L 
check remaining 
fraction for zero 
ORA 
A 
RZ 
return if zero, 
conversion complete 
BRA 
SFCI 
otherwise convert 
another digit 


Note that while eight bits is the equivalent of between two and 
three decimal digits precision, this does not guarantee that the gener- 
ated 
decimal 
fraction 
will be this 
long. 
The 
binary 
fraction 
.00000001 will convert to its true decimal value, .00390625. 
The process of fraction conversion in double precision is shown in 
example 13-10. 


A double precision 16bit unsigned fraction is in HL. Con- 
vert the fraction to decimal, printing the successive digits. 
Presume the decimal point to have already been printed 
when the subroutine is entered. 


label 
DFC 
ins!. 
ZAR 
DAD 
clear A for triple shift 
double shift fraction 


RAL 
roll carry into A 
MOV 
C,A 
copy high order to C 
MOV 
D,H 
and lower orders to DE 
MOV 
E,L 
DAD 
H 
shift left double again 
RAL 
roll in bit shifted out 
DAD 
H 
and again 
RAL 
DAD 
D 
form low sum 
ADC 
C 
form high sum, 
propagate 
carry 
ORI 
:BO 
merge ASCII code bits 
CALL 
TTYOUT 
print the digit 
MOV 
A,H 
test fraction for zero 
ORA 
L 
zero yet? 
RZ 
yes, return to calling 
program 
BRA 
DFC 
no, go generate another 
digit 


Again, 
the reader is reminded 
that the equivalence 
of 16 bits to 
about 5 decimal digits in precision 
does not mean that this conver- 
sion will produce only 5 digits. The full decimal value of the binary 
fraction: 


If this is likely to be bothersome 
set up a limiting digit counter whose 
expiration 
terminates 
the conversion 
whether 
or not the residual 
fraction 
has become zero. This could easily be done for the routine 
in example 13-10 by loading this count into B which is unused in the 
example and using DBNZ at the end of the loop to limit the number 
of digits generated. 


Conversions between binary and octal are quite straightforward. 
Converting 
from binary to octal involves simply ORing :BO onto 
each group of three bits. Conversion from octal to binary is done by 
checking that the ASCII digit is indeed legal octal, Le., that it falls in 
the 0 - 7 range, then stripping the upper four bits from the ASCII 
code with an AND. The previous result is then shifted left three bits 
and the new digit ORed in. 
Conversion between binary and hexadecimal is a little more diffi- 
cult, because the character A does not immediately follow the char- 
acter 9 in the ASCII sequence. This requires that the check for validi- 
ty of an input hexadecimal character check against both the 0 - 9 and 
A - F ranges. If the character is in the A - F range it can be reduced to 
the proper binary sequence by subtracting seven, then removing the 
upper four bits with an AND. 
Conversion 
from binary to hexadecimal requires that the 4 bit 
group to be converted to a hexadecimal character be tested to see if it 
is greater than 9. If so a 7 is added to it. When this is done adding 
:BO to the result will give a correct hexadecimal result. The conver- 
sion from hexadecimal ASCII to binary is shown in the FHCH rou- 
tine in the debugging monitor in appendix B. The opposite conver- 
sion is shown in the CNV2HX routine. 
Another type of conversion, between decimal and floating point, 
will be taken up as part of the description of floating point in chap- 
ter 14. 


14 I 
FLOATING POINT 
ARITHMETIC 


"I was gratified to be able to answer promptly, 
and I did. I said I didn't know?' 


Life on the Mississippi 
Mark Twain 


In situations 
in which scaling numbers 
is awkward 
or impossible, 
or in which the magnitudes 
of intermediate 
results cannot 
be known 
beforehand, 
resort 
must be taken to a system of arithmetic 
in which 
scale factors 
are kept automatically. 
This system is known 
as float- 
ing point arithmetic. 
A floating 
point number 
resembles 
a number 
written 
in scientific 
notation 
in that it is made up of a magnitude 
that contains 
a point at 
some agreed upon place, and an exponent, 
Le., a power of the num- 
ber base, by which this magnitude 
is to be multiplied 
to yield the true 
value of the number. 
The value of: 


In a floating 
point number 
the magnitude 
is expressed 
as pure frac- 
tion. This number 
might be represented 
internally 
as: 


sign 
+ 
exponent 
10 
fraction 
.2990 


if a four digit fraction were used. In a real decimal floating point sys- 
tem eight or more digits would be used, but for illustration we will 
keep it short. The sign appended to the floating point number above 
is the algebraic sign of the number, not the exponent. Some form of 
exponent sign is required, however, to represent numbers which have 
negative exponents, like .001. 
This is accomplished by adding a constant, known as a bias, to the 
exponent. In decimal systems with a two digit exponent this bias is 
50. An indicated exponent of 50 thus means a real exponent of zero. 
The number 2.99 x 1010 would be written: 


sign 
+ 
exponent 
60 
fraction 
.2990 


the real exponent being arrived at by subtracting the bias, in this case 
50, from the given exponent of 60. The above number could be writ- 
ten with equal.numerical validity: 


A number in this form is said to be unnormalized by virtue of the 
fact that its highest fraction digit is a zero. In general, floating point 
operations 
are performed 
only on normalized 
numbers, 
i.e., on 
numbers with a significant digit in the highest fraction position. An 
unnormalized number may be normalized by shifting the fraction 
left, decrementing the exponent once for each left shift necessary to 
bring a significant digit into the highest fraction position. 
Binary floating point numbers are represented in an exactly analo- 
gous way. The usual practice is to allocate four or five eight bit 
words to a floating point number. The commonest practice is to use 
four and this form will be illustrated here. The four words are allo- 
cated as follows. One bit is used for the algebraic sign, eight bits for 
the exponent and the remaining 23 for the fraction. The range of the 
eight bit exponent is divided into two parts by using a bias of 12810 
(8016), 
The number 
one in this binary floating point form looks 
like this: 


sign 
o 
exponent 
10000001 
fraction 
.10000000000000000000000 


The meaning of the sign bit is the same as in normal fixed point, zero 
for plus and one for minus. The true value of the exponent is found 
by subtracting 
the bias of 10000000 from the given exponent of 
10000001 to give 1. The fraction value is .12 or .510, The value of the 
number is thus .5x 21 = 1. The number -5 is represented: 


The real exponent is 3, and the value of the fraction is 5/8. The num- 
ber is therefore -5/8 x 23 or -5/8 x 8= -5. The number one fourth is 
represented: 


Floating point numbers are added or subtracted by first equalizing 
their exponents, then adding the fractions. The exponents serve ex- 
actly the same function as the scale factors in fixed point arithmetic. 
They are equalized by shifting the fraction of the number with the 
smaller exponent right by a number of places equal to the difference 
of the exponents. The fractions are then added or subtracted. If the 
sum of like signed numbers carries out of the high position the entire 
fraction is shifted right to bring the carried out bit back in, the low 
bit being lost in the process, and the exponent incremented to com- 
pensate. Addition of numbers of unlike sign involves first equalizing 
the exponents as explained above, then subtracting the fraction of 
the number with the minus sign from the other. This is a subtraction 
of one unsigned magnitude from another. If the result is negative, as 
indicated by a borrow out of the high order, the fraction is two's 
complemented and the sign set to negative. Overflow can be ignored 
during this negation, since the high bit of the high order fraction is a 
magnitude bit, not a sign. The subtraction of the fractions opens the 
possibility that the difference may have leading nonsignificant zeros, 
creating an unnormalized 
number. This is corrected by shifting the 
fraction left until a one occupies the high bit, decrementing the result 
exponent by one for each shift. 


Floating point arithmetic in microcomputers is usually done by in- 
terpretive subroutines, though some hardware for the purpose is be- 
coming available. It is well beyond the scope of a book like this to 
develop a full floating point subroutine package. Some idea of how a 
simple case of floating addition works can be had by studying exam- 
ple 14-1. 


A pair of like signed floating point numbers is contained 
in the Z80's registers. The high two orders of the augend 
fraction are in HL, the low order in D and the exponent in 
E, in the biased form discussed above. The addend is con- 
tained, in identical format, in the alternate or prime regis- 
ter set. Find the floating point sum of the two numbers, 
leaving this sum in the registers in the same format. 


ins!. 
MOV 
EXX 


operand 
A,E 
get augend exponent 
swap to access addend 
in prime registers 
form difference of 
exponents. If this dif- 
ference is zero the expo- 
nents were equal and no 
shift is necessary. If it is 
positive and nonzero, 
as indicated by the ab- 
sence of carry, the num- 
ber with the smaller ex- 
ponent is already in the 
addressable register set. 
If it is negative, as indi- 
cated by carry the num- 
ber with the smaller ex- 
ponent is in the other 
register set 


BZ 
ADD 
no shift if exponents 
equal 
BNC 
SHF 
shift this number 
EXX 
shift the other one 
NEG 
negate for positive shift 
count 
SHF 
LRH 
logical right shift high 
order fraction. When 
control reaches this 
point the number with 
the smallest exponent is 
in the addressable regis- 
ter. It is this number we 
want to shift 
RLR 
rotate bit into L from H 
RDR 
rotate bit into D from L 
DCR 
A 
decrement shift count 
BNZ 
SHF 
and do it again if 
necessary. When this 
loop is finished the 
scale factors of the 
numbers have been 
equalized and the addi- 
tion can be done 
ADD 
PUSH 
H 
push high order 
fraction onto stack. 
This is so it can be re- 
trieved after the regis- 
ters have been swapped 
again 
MVI 
E,O 
clear smaller exponent. 
The result exponent is 
the larger one attached 
to the other number. 
The smaller one is 
cleared so it will not in- 
terfere with the low 


order addition which is 
about to take place 
PUSH 
D 
push low order onto 
stack 
EXX 
swap to address other 
number 
POP 
B 
pop low order addend 
intoB 
XCHG 
low order augend to HL 
DAD 
B 
form low order sum. 
Note that the result ex- 
ponent, i.e., the larger 
of the two original ex- 
ponents, is still in E and 
undisturbed because the 
smaller exponent was 
set to zero above 
XCHG 
low order sum and 
exponent to D and E, 
high order augend 
toHL 
POP 
B 
high order addend to B 
from stack 
DAC 
B 
form high order sum 
plus carry from low 
order. If a carry results 
from this addition a 
sum greater than 24 bits 
resulted. 


BNC 
EOA 
finished if no carry 
RHR 
otherwise bring the 
carry back into the high 
order result 
RLR 
moving the entire 
fraction right 
RDR 


and increment the result 
exponent 
program continues 


Example 14-1shows an extremely simple case of floating point ad- 
dition. It is intended as an illustration only. It does not address some 
problems which can arise in floating addition, the most important of 
which is known as floating overflow. Floating overflow occurs when 
the capacity of the eight bit exponent is exceeded. There is nothing to 
be done about this except to go to a floating point form which has 
greater exponent capacity. In some systems, the floating point proc- 
essor substitutes, 
without notice to the user, the largest possible 
floating point number. Beware of this practice. Find out how the 
system you are using treats this case before you get mysterious 
results. 


The generation of a number which is too small to be represented is 
known as floating underflow. The usual practice in this case is to set 
the result to zero, again with no notice to the user. Again, find out 
what your particular 
system does in this case. Setting the result to 
zero is usually the best route to follow, but will produce a surprise if 
the result is to be used as a divisor later. 


There are two principal limitations to floating point arithmetic, 
speed and precision. If the floating point is done in interpretive sub- 
routines as illustrated here, a simple addition or subtraction will re- 
quire dozens or even hundreds of computer instructions. There is no 
way to avoid this, but the process can be optimized by "tight" 
pro- 
gramming practices. A great deal of ingenuity has been expended on 
this subject by many people. One area which is subject to improve- 
ment is the shifting required to equalize the exponents. In example 
14-1this was done by a simple repetitive shift and count down. This 
works but is very slow. A better way would be to eliminate shifting 
in multiples of eight bits by moving entire words until the count had 
been reduced to less than eight. This process is shown in example· 
14-2. 


A floating point number is in the registers in the same for- 
mat as in example 14-1, with the shift count contained in 
A, as at location SHF of that example. Perform the shift 
in multiples 
of eight bits where possible, 
finishing the 
count by conventional shifting. The C register is available 
for use. Presume that the zero difference case has already 
been eliminated. 


label 
ins!. 
operand 
SHF 
MVI 
C,O 
clear C 
SHF2 
SUI 
8 
reduce shift count by 8 
JM 
SHF3 
skip out if less than zero 
MOV 
D,L 
shift the entire fraction 
by 8 bits 
MOV 
L,H 
former high order now 
second order 
MOV 
H,C 
and clear high order 
BRA 
SHF2 
and try again 
SHF3 
ADI 
8 
restore count. If the 
result here is a zero the 
shift count was an in- 
tegral multiple of 8 and 
the shifting is done 
BZ 
SHF5 
skip if zero 
SHF4 
LRH 
otherwise complete 
RLR 
with conventional shift 
RDR 
DCR 
A 
BNZ 
SHF4 
SHF5 
program continues 


While some of the deficit in speed can be made up by careful pro- 
gramming, the loss of precision in floating point operations is anoth- 
er matter. The principal reason for the precision loss in addition and 


subtraction 
is the shifting required to equalize the exponents. 
As the 
number with the smaller exponent is shifted right, the bits shifted out 
are simply lost, the result being that the floating point sum is some- 
what smaller than the true sum. The amount 
of the loss varies with 
the length of the fraction 
and the difference 
between the exponents. 
If the exponent 
difference 
is greater than or equal to the number 
of 
fraction bits the effect is to zero the number being shifted. A floating 
add in these circumstances 
effectively becomes a rather elaborate 
do- 
nothing instruction. 
If possible, therefore, 
it will pay to add floating 
point 
numbers 
in such a way as to minimize 
this shifting, 
Le., to 


form the sum in such a way that the exponent of the next number to 
be added is as nearly equal to the exponent of the sum already devel- 
oped as possible. 
Effectively, 
this means adding the numbers 
from 


smallest to largest, rather than largest to smallest. 


The effect of this precision 
loss is best seen in a decimal illustra- 


tion. Let's go back for a moment 
to the decimal floating 
point sys- 


tem discussed at the beginning 
of this chapter, 
using a two digit ex- 
ponent 
and 
a four 
digit 
fraction. 
Consider 
the 
following 
three 
numbers: 


number 
3.904 
7.115 
2.717 


floating point 
51 
.3904 
51 
.7115 
51 
.2717 


We will add these numbers in two different 
orders. First add the bot- 
tom two numbers: 


51 
+ 
51 


51 


.2717 
.7115 


.9832 


Since the exponents 
were the same, no pre-addition 
shift was neces- 
sary and the fractions 
could be added 
directly. 
Now add the top 
number to this sum: 


51 
.9832 
+ 
51 
.3904 


51 
1.3736 


which is adjusted to normal floating point form by shifting the sum 
right to make it pure fraction and incrementing the exponent. This 
result is: 


the final 6 being lost in the shift. 


Now add the numbers ip the other order, from top to bottom. 


Adding the top pair: 


51 
.3904 
+ 
51 
.7115 


51 
1.1019 


which is adjusted to: 


52 
.1101 


the 9 digit being lost in the shift process. Now we add the third 
number: 


52 
.1101 
+ 
51 
.2717 


This addition cannot be done in this form because the exponents are 
not equal. They are equalized by shifting the fraction of the bottom 
number right one place and incrementing the exponent. The second 
number now looks like this: 


52 
+ 
52 
52 


.1101 
.0271 


.1372 
or 13.72 


Neither sum is correct, the true value being 13.736, but the first val- 
ue is much closer. It is easy to see why this happened. In the first ad- 
dition, the sum did not cause the exponent value to change, so that 
the third number could be added without a pre-addition shift. This 
caused an overflow which had to be corrected by shifting the result 
right but only the last digit of the final sum was lost in the shift. In 
the second case the first addition caused the exponent to change, los- 
ing the low digit in the compensating shift. Even more important, 
this made the exponents unequal when the third number was added, 
forcing a pre-addition shift. The low digit of the third number 
was thus lost before the addition had taken place, resulting in a 
smaller sum. 
The same effect appears in binary floating point, of course. The 
effect is intrinsic to floating point methods, not any number system. 
This kind of precision loss can be minimized, but never eliminated. 
There are a couple of approaches which can be taken to cut the loss. 
The first is the use of a so-called "guard digit". Using the guard digit 
approach, the bits shifted out during the pre-addition shift are saved 
and shifted back in if the result requires normalization, Le., if lead- 
ing zeros were generated in the fraction by the operation. This helps 
a little, a very little. 
Another approach to the problem is known as noisy mode. In the 
absence of a guard digit, bits shifted out during exponent equaliza- 
tion are simply lost. If post normalization is required, zero bits are 
shifted in. Using noisy mode ones can be shifted in instead. With 
zeros shifted in the sum will always be too small. With ones shifted 
in it will be too large. The problem can be run in both modes and an 
idea of the precision loss gained by comparing the results. This ap- 
proach to the problem of floating point precision loss was the one 
taken 
on 
the 
IBM 7030 of 
the 
late 
1950's, the 
legendary 
"STRETCH" 
machine. STRETCH took an even more realistic ap- 
proach to floating point loss, the only really effective approach. It 
used a 64 bit word, allowing a fraction length which would satisfy 
the precision requirements of all but the pickiest theoreticians. Such 
machines are, unfortunately, long gone, and their loss is mourned. 
Floating multiplication and division are, by contrast, simpler than 
addition and subtraction. The product is formed by multiplying the 
two fractions. The result exponent is formed by adding the expo- 
nents of multiplier and multiplicand and subtracting the bias. If the 


multiplication of the fractions yielded a product whose highest bit 
was zero, e.g.. 1000 ... 
times .1000... , the result fraction is shifted 
left and the exponent decremented to give a normalized result. Divi- 
sion is equally straightforward. The exponent of the quotient is the 
difference of the exponents of dividend and divisor. The dividend 
fraction is divided by the divisor fraction, to yield the result fraction. 
If the division is impossible because the dividend fraction is greater 
than or equal to the divisor fraction, the divisor fraction is shifted 
right one bit and the result exponent incremented to compensate. If 
the divisor has already been verified to be nonzero, this guarantees 
divisibility, since the dividend fraction will now have a zero in the 
high bit position while the normalized divisor fraction has a one in 
this position. The actual division of the fractions is done by the 
method described at the end of chapter 8. 
The eight bit exponent used here allows numbers in the range 1O:t38 
to be represented. Where greater range is required a variant floating 
point scheme is sometimes used which achieves greater range in the 
same overall space, but further sacrifices precision in doing so. This 
scheme involves the use of a true hexadecimal exponent. The expo- 
nent, while written as a binary number, is interpreted as a power of 
16, not 2. The fraction is still binary. The implication of this struc- 
ture is that a change of 1 in the exponent yields a change of a factor 
of 16in the value of the number. What this means in terms of lost 
precision is not so obvious. A typical implementation of this floating 
point form uses one bit for the sign as usual, 7 bits for the exponent, 
and 24 for the fraction. The number one in this form looks like this, 
omitting the sign: 


exponent 
1000001 
fraction 
.000100000000000000000000 


The effective value of the exponent is one after removing the bias, 
meaning 161 not 21 as we have experienced before. The value of the 
necessary fraction thus becomes 1/16, not 1/2, Le., 1= 1/16 X 161• 
This means that the number cannot be normalized as the leading 
zeros must be present. For the number one this makes no difference, 
but for a number involving a repeating binary fraction, like 1.110, the 
precision loss due to the leading zero bits is serious. The overall ef- 
fect is that this form of floating point gives only 21 guaranteed bits 


of precision, 
even though 
the nominal 
fraction 
length is 24 bits. 
Floating 
point 
arithmetic, 
then, 
is a trade 
of precision 
and speed 
for range. 
If the trade is necessary 
make it, but only if it is necessary. 
Floating 
point 
arithmetic 
is a useful, 
legitimate 
tool 
which 
has a 
place in the programmer's 
lexicon, 
but be careful 
with it and above 
all be aware of its limitations. 
No programmer 
who aspires to the ef- 
fective use of floating 
point 
arithmetic 
should 
be without 
a copy of 
what has come to be the classic work in the area, Rounding Errors in 
Algebraic Processes, by J. H. Wilkinson 
(Prentice-Hall, 
1963). 
Conversion 
of floating 
point numbers 
between 
decimal and binary 
involves use of a method 
known 
as radix deflation. The general 
idea 
of the method 
is to eliminate 
the binary 
exponent 
in stages 
while 
building 
a decimal 
exponent. 
We will illustrate 
the case in which the 
true value of the exponent 
is positive and then generalize 
it. Take the 
floating 
point number: 


exponent 
10000111 
fraction 
.111111100000000000000000 


The true value of this exponent 
is 7, while the value of the fraction 
is 
127/128. 
The 
value 
of 
the 
number 
is therefore 
127/128x27 
or 
127/128 x 128 = 127. For clarity 
we will rewrite 
this in decimal 
and 
work through 
the example in decimal. 
The number 
is: 


fraction 
127 


128 


We begin by subtracting 
3 from the binary 
exponent. 
This has the ef- 
fect of dividing 
the number 
by 8. In addition, 
we multiply 
the frac- 
tion by 4/5. 
The total effect of these two steps is to divide the float- 
ing point number 
by ten. This entitles us to increment 
the decimal ex- 
ponent 
by one. The number 
now looks like this: 


binary exponent 


4 


fraction 
127 
x~ 


128 
5 


decimal exponent 


1 


since the binary exponent is still greater than 3 we repeat the process, 
subtracting 
3 from the binary exponent, 
multiplying the fraction 
again by 4/5 and adding one to the decimal exponent. The result 
looks like this: 


fraction 
127 
4 
4 
--x-x- 
128 
5 
5 


Since we can no longer subtract 3 from the binary exponent without 
going negative, we stop here. The remaining 1in the binary exponent 
can be disposed of by doubling the fraction. The result now looks 
like this: 


fraction 
127 
4 
4 
--x-x-x2 
128 
5 
5 


This last doubling of the binary fraction is done in the real conver- 
sion by a left shift. The binary exponent has now been gotten rid of. 
The value of the former fraction is: 


127 
4 
4 
127 
-- 
x - 
x - 
x 2 = -- 
= 1.27 
128 
5 
5 
100 


This single integer digit and the fraction can be converted to decimal 
by the normal fixed point means. Attaching the generated decimal 
exponent we have: 


If the binary exponent is negative it is incremented by three and 
the fraction multiplied by 5/4 instead of 4/5. This effectively multi- 
plies the floating point number by ten. The decimal exponent is then 
decremented by one. This process continues until the binary expo- 
nent is positive and less than 4. The residual binary exponent is then 
disposed of by a left shift of the fraction, producing a single integer 
digit and a binary fraction which are converted by the normal fixed 


point means. The decimal exponent is then converted as a negative 
number and attached to the result. 


Conversion from decimal to binary follows the same general plan. 


The decimal exponent is reduced (deflated) and a binary exponent 
~ili~. 
- 


There are some practical difficulties which arise with application 
of the radix deflation method. Perhaps the most significant is caused 
by the fact the 4/5 is not exactly representable 
as a binary frac- 
tion, Le.: 


This introduces 
a loss of preClSlon during 
the conversion, 
the 
amount of the loss depending on the magnitude of the number being 
converted, 
since for numbers with large positive binary exponents 
many iterations through the process, meaning many multiplications 
by 4/5, will be necessary. There are a number of measures which will 
keep this error under control. First, the multiplication by 4/5 should 
be done in at least one word greater precision than that used for the 
binary fraction. This helps confine the error to the extra order which 
will not be converted. The error can be further reduced by reducing 
the number of multiplications. 
This is done by dividing by 100 or 
1000 at a time rather than 10. To divide by 100 reduce the exponent 
by 6 instead of 3. This effectively divides by 64. The fraction is then 
multiplied by 16/25, the square of 4/5 and the decimal exponent is 
incremented twice. The importance of this is that only one multipli- 
cation is done instead of two. Division by 1000 is done by reducing 
the binary exponent by 9, multiplying the fraction by 64/125, the 
cube of 4/5, and incrementing the decimal exponent by three. After 
every multiplication, 
the resulting fraction must be checked for nor- 
malization. 
If the high fraction bit has become a zero, the fraction 
should be shifted left and the binary exponent incremented. Keeping 
the fractIon normalized in this way also helps to reduce the error. 


15 I 
GRAPHIC OUTPUT 


"One picture is worth more 
than ten thousand words!' 


Graphic output of computed results allows a large amount of data 
to be displayed in an easily interpretable 
form, allowing trends and 
relations 
to be seen which might easily be obscured if the data were 
viewed in their raw numerical 
form. For this reason programmers, 
almost from the beginning of the craft, have sought to invent meth- 
ods for displaying 
results in graphic form. It is the purpose 
of this 
chapter to show the elementary methods by which such data displays 
are constructed. 
Perhaps 
the simplest type of graph is that shown in figure 15-1. 
This display shows a distribution 
of test scores, the length of each 
column indicating 
the number of scores which fell into the indicated 
interval. 
This type of display is known as a histogram or frequency 
plot. 
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The construction 
of such a display involves processing the raw 
scores into a table of frequencies. This table is simply an array in 
memory, the successive members of which contain the number of 
scores which fell into the interval indicated by the array member. In 
our example the scores are grouped into intervals of 5. The first fre- 
quency array member will thus contain the number of scores less 
than 5, the second the number 5 or greater but less than 10, etc. To 
build this table of frequencies the array of twenty memory words 
must first be cleared. The raw scores are then processed by dividing 
each by the interval size, in this case 5, yielding a quotient in the 0 - 
19 range. The score 100 is forced into the 20th interval. This result is 
then used as a displacement to increment the appropriate 
member of 
the frequency table. The required address is computed by adding the 
displacement to the base address of the frequency table. The word at 
this computed address is then incremented and the entire process re- 
peated for each score in the table of raw data. 


The division by 5 can be done by a faster and more direct method 
than a full software divide using the expression: 


Since the denominators 
of these fractions are all powers of two the 
implied divisions can all be accomplished by right shifts. To preserve 
precision the above series is rewritten: 


N-N/4+N/16 


4 


the division by four being left to the last step. 
The actual display is created by typing a constant character under 
control of a count, this count being the number of scores which fell 
into the interval represented by the line. Both the construction 
of 
the frequency table and the printing of the display are shown in ex- 
ample 15-1. 


SCORES. 
Create 
the 
program 
necessary 
to 
determine 
their frequency 
distribution 
and plot it as the histogram 
shown in figure 15-1. Space for the frequency 
array is cre- 
ated by: 


label 
inst. 
FARRAYRES 
operand 
20 


The program 
to build the frequency table and plot the his- 
togram is: 


FREQ 
LXI 
H,FARRAY 
address of frequency 
array to H 
MOV 
D,H 
copy to DE 
MOV 
E,L 
INX 
D 
increment 
for move 
LXI 
B,19 
the number of 
necessary moves is one 
less than the actual 
space to be cleared 
ZAR 
MOV 
M,A 
clear the first array 
word 
MW+R 
clear the array 
LXI 
X;SCORES 
address of raw score 
array to X 
MVI 
B,70 
number of raw scores to 
B 
LXI 
H,FARRAY 
address of array origin 
PUSH 
H 
to HL. This is pushed 
onto the stack so it can 
be easily retrieved later 
without using an LXI 


FRl 
LAX 
0 
pick up raw score 
INX 
X 
increment pointer 
MOV 
E,A 
now divide by 5, save 
original value 
LRA 
LRA 
N/4 
MOV 
C,A 
save N/4 
LRA 
LRA 
N/16 
ADD 
E 
add original value of N 
SUB 
C 
subtract N/4 
LRA 
now the final division 
by4 
LRA 
and we have N/5 
CPI 
20 
was the original score 
100 
BLS 
FR2 
skip if not 
MVI 
A,19 
otherwise force it into 
the last interval 
FR2 
MOV 
E,A 
move computed 
displacement to E 
MVI 
D,O 
clear upper half of 
displacement addend 
POP 
H 
retrieve address of 
frequency table origin 
PUSH 
H 
reset stack pointer for 
next fetch 
DAD 
D 
form address of word in 
frequency table origin 
INR 
M 
and increment the 
memory word. Since 
there are only 70 total 
scores this cannot 
overflow 
DBNZ 
FRl 
and do it again 
POP 
H 
restore stack pointer 


LXI 
H,BORDER 
print the dashed graph 
border 
CALL 
PRT 
LXI 
X,FARRAY 
address 
of array origin 
toX 
MVI 
D,O 
clear D for interval 
numbering 
MVI 
B,20 
line count to B 
PLOTl 
MVI 
A,:8D 
return 
Teletype carriage 
CALL 
CHOUT 
MVI 
A,:8A 
CALL 
CHOUT 
MOV 
A,D 
get interval 
ADI 
5 
increment 
interval 
by 5 
DAA 
decimal adjust 
result 
MOV 
D,A 
save for next pass 
MVI 
A' 
blank to A for first 
, 
BNC 
PLOTlA 
character 
of line except 
if the DAA caused a 
carry. If this was the 
case, the result of the 
DAA had to be 100, 
i.e., 00 and a carry. The 
first character 
in this 
case must be a one in- 
MVI 
A,'l' 
stead of a blank 
PLOTlACALL 
CHOUT 
print first character, 
whatever 
it is 
MOV 
A,D 
get two interval 
digits 
RAR 
move high BCD digit to 
low four bits 
RAR 
RAR 
RAR 
ANI 
:F 
clear upper four digits 
ORI 
'0' 
form ASCII character 


CALL 
CHOUT 
print high ASCII 
interval digit 
MOV 
A,D 
get interval digits again 
ANI 
:F 
clear high BCD digit 
ORI 
'0' 
form low ASCII digit 
CALL 
CHOUT 
print it 
MVI 
A' 
print blank between 
, 
interval and left border 
of graph 
CALL 
CHOUT 
LAX 
0 
get count in this interval 
MVI 
C,'O' 
digit frame to C 
PLOT2 
SUI 
10 
convert count 
BC 
PLOT3 
INR 
C 
BRA 
PLOT2 
PLOT3 
ADI 
:BA 
this add takes the place 
of both the ADI 
10 
which would have been 
necessary to restore the 
number to its condition 
before the last subtrac- 
tion and the ORI 
'0' 
required to form the 
ASCII character 
PUSH 
PSW 
save units digit 
MOV 
A,C 
retrieve tens digit 
CPI 
'0' 
leading digit zero? 
BNE 
PLOT4 
skip ifnot 
MVI 
A' 
substitute blank 
, 
PLOT4 
CALL 
CHOUT 
print tens digit 
POP 
PSW 
retrieve units digit from 
stack 
CALL 
CHOUT 
print it 
MVI 
A,'I' 
print border 
CALL 
CHOUT 
character 


LAX 
0 
get count in interval 
again 
INX 
X 
bump pointer up 
ORA 
A 
count zero? 
BZ 
PLOT 6 
anything to print? If so 
MOV 
C,A 
move count to C. The 
count will be used to 
control the length of the 
string of characters 
(asterisks) printed 
MVI 
A '*' 
plotting character 
to A 
, 
PLOTS 
CALL 
CHOUT 
print character 
DCR 
C 
decrement count 
BNZ 
PLOTS 
do it again if count not 
zero 
PLOT6 
DBNZ 
PLOTt 
decrement interval 
count, do it again if not 
zero 
LXI 
H,BORDER 
print lower border of 
graph 
CALL 
PRT 
program 
continues 


The ASCII string for the upper and lower borders 
of the 
graph is created by: 


BORDER 
ASC 
+ ---- + ---- + ---- + ---- + ' 
DATA 
:8D 


This last carriage return (:8D) is required as the terminator 
by the PRT routine, as previously discussed. 


A more common 
plotting 
requirement 
involves plotting 
the value 
of one variable against another, 
commonly 
called an X-Y plot. This 
type of plot is usually done by construction 
of an image of the graph 
in memory. 
A space known as the image region is allotted in memory 
and set to ASCII 
blanks. 
The list of points 
to be plotted 
is then 
scanned 
and an address 
in the image 
region 
computed 
for each 
point, 
this address 
corresponding 
to the eventual 
position 
of that 
point on the plot. The blank at this location is then replaced by what- 
ever character 
has been chosen to represent the plotted points. 
The fact that the printing of the graph takes place from top to bot- 
tom makes the construction 
of the image a bit awkward, 
since the 
points with the highest Y value occupy the memory 
locations 
with 
the lowest addresses. 
The adjustment 
for this is fairly simple. The Y 
value of the point to be plotted is first checked for range, to see if it 
falls within the borders 
of the graph. 
If it is in range the maximum 
possible value for Y, 40 in the case of the example to follow, is sub- 
tracted from the Y value of the point to be plotted. 
This gives a zero 
or negative value which is then negated to yield a line number in the 0 
through 
N-l range, where N is the number of lines in the graph. This 
number is then multiplied 
by the width, in characters, 
of the graph. 


The X value of the point, after being checked for range, is then add- 
ed to this number. 
This gives the address of the memory word which 
represents 
that point on the graph, 
relative to the beginning 
of the 
image region. The addition of the address of the first word of the im- 
age region to this relative address completes the necessary computa- 
tion. The result is the address 
of the memory 
word into which the 
plotting 
character 
must be placed. This process is then repeated 
for 
each point to be plotted. 


The printing 
of the finished graph is then a straightforward 
pro- 
cess, the result being shown in figure 15-2, which is a 40 by 40 first 
quadrant 
X-Y plot. The disproportion 
of the axes was necessary to 
keep equal resolution 
in both X and Y, since a Teletype prints 
10 
characters 
per inch horizontally 
but only 6 per inch vertically. 
The upper border 
of the graph is first printed as in example 
15-1. 


The contents of the image region memory locations 
are then printed 
in groups of 40 (in this case, since the plot is 40 wide) preceded and 
followed by whatever vertical border material is required. 
The lower 
border is then repeated to finish the graph. The details of this type of 
plot are shown in example 15-2. 


Construct 
a program 
which will plot and type out a 40 by 
40 X-Y plot as in figure 
15-11. The X data are in an array 
which begins at location 
X, and the Y data are in an equal 
length array beginning 
at Y. The array length, 
N, has been 
defined 
elsewhere 
with an EQU. 


label 
ins!. 
operand 
XYPLOT 
LXI 
H,IMAGE 
address 
of image region 
LXI 
X,X 
address 
of X data to X 
register 
LXI 
Y,Y 
address 
of Y data to Y 
register. 
Note that the 
names of the X and Y 
data arrays do not con- 
flict with the names of 
the registers. 
The as- 
sembler knows the dif- 
ference. 
Memory 
loca- 
tions may be given any 
legal name. There are 
no reserved 
symbols 
in 
this assembler 
MOV 
D,H 
copy image address 
to DE 
MOV 
E,L 
INX 
D 
increment 
"to" 
address 
for move 
MVI 
A' 
ASCII 
blank to A 
, 
LXI 
B,1599 
the reserved 
space for a 
40 by 40 image is 1600 
words. 
The number 
of 
moves will be one less 
than this 
MOV 
M,A 
set first word of image 
to blank 


MW+R 
set image region to 
blanks 
MVI 
B,N 
count of points to be 
plotted 
to B 
MVI 
C,t 
the C register will be 
used as a counter 
to 
determine 
the interval 
at which the "tick" 
mark should be inserted 
in the vertical border 
Pt 
LAX 
0 
get X coordinate 
of 
point 
CPI 
40 
out of range? 
BGE 
OUT 
yes if greater 
than 39 
LAY 
0 
get Y coordinate 
CPI 
40 
test for range 
BGE 
OUT 
SUI 
39 
if Y is in the 0 - 39 range 
NEG 
subtract 
the vertical 
bias, then negate 
MOV 
L,A 
move to L and zero H in 
preparation 
MVI 
H,O 
for multiplication 
by 
graph width 
DAD 
H 
since 40= 32+ 8 we 
can shift left 
DAD 
H 
3 times to multiply 
by 8, 
DAD 
H 
then twice more to 
multiply 
by 32, and add 
MOV 
D,H 
save in DE 
MOV 
E,L 
DAD 
H 
DAD 
H 
DAD 
D 
40 times the "inverted" 
Y coordinate 
in DE 
LEX 
0 
X coordinate 
to E 
register 


MVI 
D,O 
clear D for double 
addition 
DAD 
D 
HL now contains 40 
times the Y displace- 
ment plus the X coor- 
dinate. This is the ad- 
dress of the point to be 
plotted relative to the 
beginning of the image 
region 
LXI 
D,IMAGE 
now add the address of 
DAD 
D 
the first word of the 
image region to form 
the memory address of 
the point to be plotted. 


MVI 
A ,*, 
plotting character 
to A 
, 
MOV 
M,A 
place plotting character 
in memory word 
OUT 
INX 
X 
increment X pointer 
INX 
Y 
increment Y pointer 
DBNZ 
PI 
and repeat until B is 
zero 
LXI 
H,BORDER 
print top graph border 
CALL 
PRT 
LXI 
H,IMAGE 
address of completed 
image region to HL 
MVI 
D,40 
line count to D 
P2 
MVI 
B,40 
line width to B 
MVI 
A,:8D 
return Teletype carriage 
CALL 
CHOUT 
MVI 
A,:8A 
CALL 
CHOUT 
MVI 
A,'I' 
get border character 
DCR 
C 
time for "tick" 
mark? 
BNZ 
P2A 
not if C isn't zero yet 
MVI 
C,5 
yes, reload C with 
count 


MVI 
A,' +' 
and get "tick" 
mark 
P2A 
PUSH 
PSW 
save on stack for other 
end of line 
CALL 
CHOUT 
print border 
character 
P3 
MOV 
A,M 
get image character 
INX 
H 
bump pointer 
CALL 
CHOUT 
print image character 
DBNZ 
P3 
end of line yet? 
POP 
PSW 
yes, retrieve border 
character 
CALL 
CHOUT 
and print it 
DCR 
D 
last line? 
BNZ 
P2 
not until D is zero 
LXI 
H,BORDER 
print lower graph 
border 
CALL 
PRT 


BORDER 
ASC 
ASC 
DATA 


, + ---- + ---- + ---- + ---- + ' 
,---- + ---- + ---- + ---- + ' 
:8D 


As in example 
15-1, the PRT 
and 
CHOUT 
routines 
are 
those previously 
illustrated. 


Example 
15-2 raises an interesting 
possibility. 
Since all of the plot- 
ted points of the graph except the border 
are either blank or asterisk, 
they could be represented 
by single one or zero bits. This would 
al- 
Iowa 
single bit to represent 
a graph point rather 
than an entire word, 
resulting 
in a much 
smaller 
memory 
requirement 
for the internal 
graph image. 
The required 
memory 
image space for the graph in ex- 


ample 15-2 would be 200 words instead of the 1600 used. This would 
require 
the manipulation 
of individual 
bits in memory, 
a task for 
which the Z80 is equipped with special instructions. 
Any bit in an 8 bit register or a memory word may be individually 
tested, set to one, or cleared to zero by means of special Z80 bit man- 
ipulation 
instructions. 
The general mnemonic 
for testing bits in any 
register is BTr, in which the small r is the name of an 8 bit register. 
The bits are considered 
to be numbered 
starting with zero from the 
right, the leftmost 
bit being bit 7. The result of a BTr instruction 
is 
the setting of the Z flag in the F register to reflect the outcome of the 
test. The sequence: 


BTC 
3 
BZ 
ZILCH 


will transfer 
control to location 
ZILCH 
if bit 3, Le., the fourth 
bit 
from the right in register C is zero. Similarly, the sequence: 


BTL 
0 
BNZ 
ODD 


will send control to location 
ODD if the lowest bit, bit zero, of the 
L register is a one, Le., if the L register contains 
an odd number. 


Bits in a memory 
word pointed 
to by HL may be tested by a se- 
quence like: 


BTM 
BNZ 
7 
MINUS 


will test the high bit of the word whose address is contained 
in HL 
and send control to MINUS if the high bit, Le., the sign bit, is a one. 
A bit in a register or memory may be forced to one by the BSr in- 
struction, 
the small r again being the name of an eight bit register 
or an M, the M meaning the memory word pointed 
to by HL. The 
instruction: 


will force the low bit, bit 0, of the B register to one. This facility may 
be used to implement a true arithmetic left shift on the Z80. In this 
type of shift the seven magnitude bits are shifted left, introducing a 
zero in the rightmost bit, but leaving the sign unchanged. An arith- 
metic left shift is accomplished by: 


clear highest magnitude 
bit 
sign bit to carry, shift 
left 
skip if it was positive 
otherwise set sign 
negative 


BNC 
B8A 


Note that this procedure does not detect the loss of a significant bit 
through the shift. Note also that the SLA mnemonic used by Zilog 
for arithmetic left shift does not in fact perform an arithmetic shift 
but a logical shift. This is equivalent to the LLA instruction in our 
assembler. Bits in memory may be forced to ones by the B8M in- 
struction. This forces the bit named in the operand of the B8M in the 
memory word pointed to by HL to be forced to one. 
Bits in registers or memory may be cleared to zero by the BCr and 
BCM instructions, 
r again being the name of an eight bit register, 
and M meaning the location pointed to by HL. 


The X and Y registers may also be used by the bit test, clear and 
set operations 
to point to their operands. 
The mnemonic changes 
in this case by appending 
the name of the pointer register. The 
instruction: 


means test bit 3 of the word pointed to by X, the displacement of the 
instruction being zero. The instruction: 


forces bit 5 of the word three beyond the one pointed to by Y to 
one, while 


clears the number 6 bit of the word two lower than that pointed to 
byX. 
The principal weakness of the bit manipulation instructions is 
that, while the address of the operand word may be held in registers 
HL, X, or Y, the bit identification within the word is assembled as 
part of the instruction. Since placing points within an image in a plot 
routine would require that the bit address of the point be computed 
individually for each point, the instructions themselves would have 
to be modified. This makes the procedure very awkward and renders 
it useless for programs held in ROM. Perhaps in a future machine 
facility could be provided for holding the bit identification as well as 
the operand word address in a register. This would open up a large 
number of useful possibilities for the bit manipulation instructions. 
As these instructions stand, they are much less useful than they 
could be. 
The final exercise in this chapter involves an extra twist on X-Y 
plotting, the addition of a true third dimension to a two dimensional 
graph. This is shown in figure 15-3.This plot is used by astronomers 
and is known as a Hertzsprung-Russell diagram, named for the as- 
tronomers who devised it. Its meaning is interesting enough to allow 
a short diversion into it. Those not interested in astronomy can skip 
over to the details of how the plot is actually done. The Hertzsprung- 
Russell diagram, or HR diagram for short, is a plot of the true 
brightnesses of stars against their colors. The vertical coordinate is 
absolute magnitude, the magnitude a star would display if it were at 
a standard distance of one parsec, about 3.26 light years. Magnitude 
is a logarithmic scale of brightness, a difference of 5 magnitudes 
meaning a difference of 100 in actual light energy received. The 
brighter a star is, the more negative its magnitude. Thus the star 
whose magnitude is -1 near the top of the graph is 100 times brighter 
than one whose magnitude is + 4. 
The horizontal coordinate is the spectral class of the star, a 
rough measure of its surface temperature. Stars at the left of the 
graph are blue or blue-white, the change in color progressing 
through yellow to red at the extreme right. The OBAFGKM classifi- 
cation across the top corresponds to a classification scheme in which 


the temperatures of the stars may be roughly estimated from the ap- 
pearance of their optical spectra. 
The most interesting feature of the HR diagram is the broad diag- 
onal stripe of stars from upper left to lower right. This group of stars 
is known as the main sequence, 
of which the sun is a member. 


Though it is not actually plotted here, the position of the sun in this 
scheme is at spectral class G2, just to the right of the center of the 
graph and absolute magnitude 4.8, about 2/3 of the way down from 
the top. The group of stars at the upper right, known as the giants, 
have evolved from stars which formerly occupied the upper end of 
the main sequence. The principal source of the vertical scatter in the 
diagram is the uncertainty in the distance measurements from which 
the absolute magnitudes are computed. Readers interested in further 
details of the HR diagram can find them in any modern text on as- 
tronomy or astrophysics. 
The plotting of such a diagram involves several extra twists over a 
simple X-Y plot. The first is that some indication must be given of 
how many stars fell within a single diagram 
cell. This involves 
changing the plotting character to reflect this number. Second, the 
horizontal 
coordinate 
is alphabetic, 
and not an orderly alphabetic 
scheme at that. The alphabetic horizontal coordinate must be trans- 
formed into a numerical one to allow points to be plotted horizontal- 
ly. Finally, the vertical coordinate is inverted, increasing downward 
rather than upward as with most plots. The plotting and printing of 
the Hertzsprung-Russell 
diagram in figure 15-3 is shown in example 
15-3. 


Create the program which will construct the image of the 
Hertzsprung-Russell 
diagram in figure 15-3 and print it. 


The data for the diagram are in ASCII, five characters per 
star, in a single data array beginning at SDATA. The for- 
mat of the five word entries in SDATA is: 


3rd character: 
the algebraic sign of the absolute 
magni- 
tude, - for negative and blank for positive. 


4th and 5th characters: 
the numerical 
magnitude 
itself, 
with the decimal point omitted. 
Only the integer and 
first fraction digit are given. 


In this format the data for the star at the upper left corner 
of the diagram are: 


while the data for the star at the lowest part of the diagram 
are: 


meaning 
spectral 
class B9, absolute 
magnitude 
-1.0 and 
spectral class K5 absolute 
magnitude 
+ 6.8. The program 
for the generation 
and printing of the diagram is: 


label 
inst. 


HRDGRMLXI 


ZAR 
MOV 


operand 
H,IMAGE 
address of image region 
toHL 
D,IMAGE+l 
address of second word 
to DE 
clear A 
M,A 
set 1st image word to 
zero 
B,3263 
the image region is 51 
lines by 64 characters 
or 
3264 words. The num- 
ber of moves required 
to zero the region is one 
less than this. 
clear the entire image to 
zero 


LXI 
X,SDATA 
address 
of data array to 
X 
LXI 
B,N 
number 
of stars to B 
HI 
LAX 
0 
get alphabetic 
spectral 
class 
MVI 
D,O 
clear D to transform 
to 
number 
CPI 
'0' 
was it spectral 
class O? 
This is an "oh" 
not a 
zero 
BEQ 
H3 
skip if so 
MVI 
D,10 
increment 
numerical 
class 
CPI 
'B' 
spectral 
class B? 
BEQ 
H3 
skip if so 
MVI 
D,20 
increment 
numerical 
class 
CPI 
'A' 
spectral 
class A? 
BEQ 
H3 
MVI 
D,30 
CPI 
'F' 
spectral 
class F 
BEQ 
H3 
MVI 
D,40 
CPI 
'G' 
spectral 
class O? 
BEQ 
H3 
MVI 
D,50 
CPI 
'K' 
spectral 
class K? 
BEQ 
H3 
MVI 
D,60 
CPI 
'M' 
spectral 
class M? 
BEQ 
H3 
if control 
gets past here 
the spectral 
class was 
not one of the defined 
ones and the star will be 
ignored 
H2 
JMP 
NXT 
skip this star 


H3 
LAX 
1 
pick up numerical 
subclass 
CPI 
'0' 
check numeric 
validity 
BLS 
H2 
skip if not numeric 
CPI 
:BA 
greater 
than 9? 
BGE 
H2 
skip if so 
ANI 
:F 
valid, clear upper four 
bits 
ADD 
D 
add transformed 
spectral 
class 
SUI 
6 
this 6 is subtracted 
because the classes 00 
through 
05 are not plot- 
ted. A now contains 
a 
number 
0 - 63 
MOV 
E,A 
save in E 
LAX 
2 
pick up sign of absolute 
magnitude 
MVI 
D,l 
set flag in D 
CPI 
'-' 
is absolute 
magnitude 
negative? 
BNE 
H4 
skip if not 
DCR 
D 
otherwise 
set D to zero 
H4 
LAX 
3 
pick up integer absolute 
magnitude 
digit 
CPI 
'0' 
check for numeric 
validity 
BLS 
H2 
skip star if not numeric 
CPI 
:BA 
BGE 
H2 
ANI 
:F 
clear upper four bits 
LLA 
multiply 
it by ten 
MOV 
H,A 
LLA 
LLA 
ADD 
H 


MOV 
H,A 
save digit times ten in H 
LAX 
4 
pick up absolute 
magnitude 
fraction 
digit 
CPI 
'0' 
check numeric 
validity 
BLS 
H2 
CPI 
:BA 
BGE 
H2 
ANI 
:F 
clear upper four bits 
ADD 
H 
add integer digit times 
ten 
DCR 
D 
test for negative 
BZ 
H5 
NEG 
negate binary 
magnitude 
H5 
ADI 
20 
bias positive 
JM 
NXT 
skip star if still negative 
ARA 
divide by two. This is 
done because the graph 
represents 
magnitude 
to 
1/5 rather 
than 1/10 of 
a magnitude 
CPI 
51 
fall off bottom 
of graph? 
BGE 
H2 
skip if so 
MOV 
L,A 
transfer 
to L 
MVI 
H,O 
clear upper register for 
multiply 
MOV 
D,H 
clear upper half of DE. 
The horizontal 
graph 
displacement 
is still in E 
DAD 
H 
multiply 
line number 
by 
64 
DAD 
H 
DAD 
H 
DAD 
H 
DAD 
H 


DAD 
H 
DAD 
D 
add horizontal 
displacement. At this 
point HL contains the 
address of the word to 
be incremented, relative 
to the first word of the 
image region 
LXI 
D,IMAGE 
get address of image 
origin 
DAD 
D 
address of word to be 
incremented in HL 
INR 
M 
increment the memory 
word. If this word was 
already FF 16 the result 
will be zero. This must 
be checked for and the 
cell set back to FF 16 
BNZ 
NXT 
skip if no zero 
DCR 
M 
set count back 
NXT 
LXI 
D,S 
data array increment to 
DE 
X+DE 
add increment to data 
pointer. This is 5 
because the data for 
each star requires 5 
memory words 
DCX 
B 
decrement star count 
MOV 
A,B 
check for zero 
ORA 
C 
JNZ 
HI 
do it again if necessary 
LXI 
H,STLINE 
print top spectral class 
line 
CALL 
PRT 
LXI 
H,NLINE 
print numerical 
subclass line 
CALL 
PRT 


LXI 
X,IMAGE 
address of image region 
toX 
MVI 
D,l 
"tick" 
mark trigger to 
D 
MVI 
E,-2 
vertical magnitude 
marker to E 
MVI 
C,Sl 
line count to C 
H6 
MVI 
A,:8D 
return Teletype carriage 
CALL 
CHOUT 
MVI 
A,:8A 
CALL 
CHOUT 
MVI 
B,'I' 
border character to B 
DCR 
D 
time for "tick" 
mark? 
BNZ 
HI0 
not if D didn't become 
zero 
MVI 
D,S 
yes, reload D with 
count 
MVI 
B,' +' 
"tick" 
mark for border 
character 
MOV 
A,E 
get magnitude 
INR 
E 
update magnitude 
ORA 
A 
set flags 
BNZ 
H7 
skip if not zero 
MVI 
H' 
no sign if zero 
, 
BRA 
H9 
H7 
JP 
H8 
skip if positive and 
nonzero 
MVI 
H '-' 
magnitude was negative 
, 
NEG 
force positive 
BRA 
H9 
and skip 
H8 
MVI 
H,'+' 
set sign positive 
H9 
ORI 
'0' 
merge ASCII zero. This 
can be done because the 
numerical magnitude 
never exceeds 8 due to 
the constraints of 
the diagram 


MOV 
L,A 
save magnitude 
digit 
MOV 
A,H 
get ASCII sign/blank 
CALL 
CHOUT 
print it 
MOV 
A,L 
get magnitude 
digit 
CALL 
CHOUT 
print it 
BRA 
Hll 
and skip 
H10 
MVI 
A,' 
no magnitude 
or "tick" 
mark 
CALL 
CHOUT 
print blanks at left 
of graph 
CALL 
CHOUT 
Hll 
MVI 
A' 
enter here from printing 
, 
magnitude 
above 
CALL 
CHOUT 
print one blank 
MOV 
A,B 
get border character 
CALL 
CHOUT 
print it 
PUSH 
PSW 
save border character 
for right end 
MVI 
B,64 
line length to B 
H12 
LAX 
0 
get image word 
MVI 
H' 
blank in case of zero 
, 
CPI 
0 
test for zero 
BEQ 
H14 
skip if zero 
CPI 
1 
if only one star fell into 
this cell the plotting 
character 
is an asterisk 
BNE 
H12A 
skip if not one 
MVI 
H ,*, 
set asterisk as plotting 
, 
character 
ZAR 
and clear A for OR 
BRA 
H14 
H12A 
CPI 
10 
if count was 10 or more 
use "#" as plotting 
character 
BGE 
H13 
MVI 
H,'O' 
count between 2 and 9, 
use ASCII digit 


BRA 
H14 
ZAR 
MVI 
H,'#' 


CALL 
CHOUT 
INX 
X 
DBNZ 
H12 


CALL 
DCR 
BNZ 
LXI 


CHOUT 
C 
H6 
H,NLINE 


clear A for OR 
set plotting character 
to # 
construct plotting 
character 
print it 
increment pointer 
count down and do 
it again 
retrieve border 
character 
print it again 
last line 
not if still nonzero 
print numerical 
subclass line 
CALL 
PRT 
LXI 
H,STLINE 
print spectral class label 
line 


The 
spectral 
class 
labeling 
and 
numerical 
subclass 
lines 
are 
defined by: 


RES 
ASC 
ASC 
DATA 
RES 
ASC 
ASC 
DATA 


4,' 
'0 
B 
A 
K 
M' 
:8D 
4,' 
'67890123456789012345678901234567890' 
'12345678901234567890123456789' 
:8D 


There are, of course, almost as many possible forms of graphic 
output as there are types of data to be plotted. All plots will, how- 
ever, employ the basic strategy of computing the address of a memo- 
ry word to be set or incremented to form the final image. If the mate- 
rial in this chapter 
has been thoroughly 
understood, 
the reader 
should have no trouble constructing plot programs to serve any spe- 
cial purpose. 
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16 / 
PROGRAMMING 
WITH INTERRUPTS 


Sir Winston Spencer Churchill 
First statement as Prime Minister, 
House of Commons, 
May 13th, 1940 


While the above quote may overstate the case a bit, the fact is that 
interrupts, more than any other subject associated with the program- 
ming craft, are the cause of the greatest amount of toil, tears and 
sweat. The blood only occurs in the cases of those who become truly 
desperate. The purpose of this chapter is to explain the subject in a 
one-by-one orderly fashion, hoping by this approach to dispel some 
of the confusion which seems to surround the subject. 


To understand the need for interrupts consider the following situa- 
tion. It is time for a shift change in a nuclear reactor facility. The re- 
actor control system is run by a small computer, one of whose peri- 
pheral duties is to keep track of the name of the person who is at- 
tending the main reactor monitoring console. The main job of the 
small computer, of course, is to monitor the activities of the reactor 
itself, informing the operator 
of anything strange or out of order 
which might be occurring. As each new operator comes on duty, he 
types his name on the terminal attached to the monitoring console. If 
the input/output 
methods described in chapter 12 had been used to 
accomplish this function the computer would be wholly tied up with 
the acquisition of the name of the new operator. If the operator had 
a long name, say Lambros Alexios Papatriantaphilopolis, 
and if he, 
like this writer, used the Biblical system of typing (Seek and ye shall 
find), the reactor could well go critical and melt or explode in the 
time it took to type the name. This is why interrupt systems exist. 


An interrupt system may be thought of as an automatic ready flag 
monitor which would allow the computer in the example above to 
devote its entire time to reactor monitoring, 
taking only the few 


microseconds necessary to actually transfer data when a key was 
struck, then going back to the monitoring task. The business of 
waiting in a loop which reads the device status word, testing a bit 
and repeating the process until the bit changes state would be entire- 
ly eliminated. An interrupt system therefore allows the computer to 
perform tasks on demand, taking only as much time as the actual 
data transmission requires without idling while waiting for ready 
flags. 
If there is a single concept which is most important to the under- 
standing of interrupt service, it is this: the interrupt service must in 
no way disrupt the task which is interrupted. In the hardware this 
means first that no interrupt is acknowledged while an instruction is 
in the process of being executed. Interrupt acknowledgement can oc- 
cur only between instructions, not during an instruction. It is fairly 
easy to see what would happen if this were not so. Suppose the com- 
puter were in a commercial environment, say typing paychecks, and 
were in the process of forming the final sum when an interrupt oc- 
curred. The interrupt serviceroutine would destroy the partial result, 
leaving garbage in the registers when the interrupted task was re- 
sumed. We will return to this business of disruption of the interrupt- 
ed task later, since there are other ways in which it can occur. 
We will first detail here what happens during an interrupt, leaving 
the exact mechanics of how it occurs until a little later. When an in- 
terrupt occurs the following sequence of events transpires: 


2) Based on system wiring, a number is formed which is the 
memory address of the next instruction to be fetched. 


3) The program counter is pushed onto the stack. Recall now the 
earlier and heavy emphasis which was laid on the fact that the 
program counter always points to the instruction following the 
one being executed. The address pushed onto the stack is there- 
fore that of the instruction after the one in progress when the in- 
terrupt occurred. 


4) The newly computed memory address, again based on system 
wiring for the particular device involved, is loaded into the pro- 
gram counter, effectively transferring control to this address. 


5) Further interrupts are suppressed until again allowed by the 
interrupt serviceprogram. 


6) When the interrupt service program has completed execution, its 
last act before returning control to the interrupted program is to 
again allow interrupts. 


7) The top item on the stack, which will be the address of the 
instruction following the one after which the interrupt occurred 
(if there are no stack programming errors), is popped into the 
program counter, sending control back to the instruction follow- 
ing the interrupt point. 


The above description is to be considered rough and preliminary, 
given in this form to furnish a jumping off point for the detailed dis- 
cussion to follow. In particular, there are some simplifications made 
above which will be rectified further in this chapter. 


We turn now to the specific conditions under which an interrupt 
can occur. As a base for discussion we will presume that the intet- 
rupting device is one of the terminals discussed in chapter 12. There 
are three general conditions which must be met before an interrupt 
can occur. These conditions are: 


1) The interrupt system must be enabled. The term is specific to the 
interrupt system as a whole and has nothing to do with any speci- 
fic peripheral device. It describes a CPU condition rather than a 
condition in a peripheral device or interface. The interrupt sys- 
tem is enabled by means of the EI (enable interrupts) instruction. 
If the CPU interrupt system has not been enabled it is said to be 
disabled. This term again applies to the CPU and has nothing to 
do with any peripheral device or interface. Once enabled the in- . 
terrupt system may be disabled by means of the DI (disable inter- 
rupts) instruction. If this system is disabled no interrupt can oc- 
cur under any circumstance except the so-called nonmaskable in- 
terrupt which will be discussed later. 


2) The device interface must be armed. Arming is a condition of the 
device interface and not of the CPU. It consists of connecting the 
device ready flag to the interrupt line in such a way that the inter- 
rupt line is driven true when data are ready to be transmitted. If 


the device interface is not armed, it is said to be disarmed. If the 
device interface is disarmed no interrupt from that device can oc- 
cur, though interrupts may be generated by other devices whose 
interfaces are armed if the CPU interrupt system is enabled. The 
arming of the device interface is specific to that device. No gen- 
eral procedure for devicearming and disarming can be given. 


3) The ready flag in the device interface must enter the true state, 
Le., indicate that the device is ready for data transmission or 
whatever other function is appropriate to the device. 


If any of the above conditions is not met the interrupt does not 
occur. 
The Z80 provides an unusually varied set of interrupt response 
possibilities, which we will take up one at a time. If no special action 
has been taken by the program or if an IMO instruction has been ex- 
ecuted, the Z80 CPU functions in a mode known as interrupt mode 
O.In this mode, the generation of an interrupt causes the CPU to re- 
quest a response from the interrupting device interface. This re- 
sponse takes the form of an instruction, supplied by the device inter- 
face, and executed by the CPU. This instruction is not fetched from 
computer memory, but is generated by the peripheral device inter- 
face and supplied to the CPU. The instruction is normally one of 
eight special instructions reserved for this purpose, known as re- 
starts. A restart instruction is a type of call, in that it forces the pro- 
gram counter to be pushed onto the stack. Unlike a call, however, a 
restart does not fetch its effective address from the memory loca- 
tions following the instruction. The effective address of a restart is 
contained within the one word instruction itself. Bits 3, 4 and 5 of 
the restart instruction form a value which, when multiplied by eight, 
gives the address of the next instruction to be fetched after the pro- 
gram counter has been pushed onto the stack. This allows up to eight 
different 
sources of interrupt 
to generate distinct interrupt 
ad- 
dresses, which can save considerable time in interrupt response. 
The second Z80 interrupt response mode, called mode 1, entered 
by executing an IMl instruction forces all interrupts to location :38. 
This is a simple option if only one or a few devices are capable of in- 
terrupting and there is no particular time bind. If multiple sources of 
interrupt are used in mode 1, the interrupt service routine must test 


each of the devices capable of interrupting 
until it finds the one 
which caused the interrupt. 
This is done just as in programmed 
in- 
put/ output, by reading the status word of each device and testing the 
appropriate 
bit for the ready to transmit data condition. This pro- 
cess is known as polling and is one of the more common ·methods of 
interrupt service. Because each device must be individually tested for 
the ready to transmit state this method is slow, but offers the inter- 
esting possibility of establishing a software priority among the inter- 
rupting devices, by the sequence in which they are tested. 
The final interrupt service mode of the Z80, mode 2, is entered by 
executing the 1M2 instruction. 
In interrupt mode 2 a special register 
known as the Interrupt 
Vector Register (IVR) comes into play. The 
interrupt vector register is loaded from the Z80 A register by the TIA 
(transfer to IVR from A) instruction. The contents of the IVR can be 
loaded into A by the TAl instruction. 
When an interrupt occurs in 
this mode, the CPU requests a response from the interrupting device 
interface. This response, an eight bit number the low bit of which 
must be zero, is used as the low eight bits of a memory address, the 
high eight bits being the contents of the IVR. The address thus gener- 
ated and the one following it are then accessed to form yet a second 
address. This second address is the location of the interrupt service 
routine. This scheme allows the interrupt service locations to be any- 
where in memory, in contrast to the eight lower memory locations of 
mode 0 and the single fixed location of mode 1. 


In summary, mode 0 interrupt service forms an interrupt service 
address which is a multiple of 8, beginning at memory location 0, the 
highest address being :38 (5610 or 7 x 8). This allows only eight words 
between the interrupt service addresses. Since a meaningful service 
routine can almost never be squeezed into such a small space the in- 
struction at the interrupt service location will usually be a JMP to 
some higher location at which the service routine can be accommo- 
dated. In mode 1 all interrupts are forced to a common location, :38, 
and the service routine at that location has the responsibility of fig- 
uring out which device caused the interrupt. In mode 2, an address is 
computed using the contents of the IVR as the high eight bits and the 
device response as the low eight bits. The low bit of the device re- 
sponse must be zero. This address is used as a pointer to another ad- 
dress in memory. This second address is a pointer to the actual inter- 
rupt service routine. In all modes the eventual result of the interrupt 


is to push the program counter onto the stack and begin execution at 
the computed interrupt 
service address. Simultaneously, 
the CPU 
interrupt system is disabled, so that no further interrupt can occur, 
except the nonmaskable 
interrupt, 
until an EI instruction has been 
executed. 
For the vast majority of application cases, interrupt mode 0 will 
suffice. This mode mimics the action of the 8080 family machines 
and must be used if compatibility with the 8080 is to be preserved. 
As a matter of terminology, 'an interrupt system capable of generat- 
ing distinct interrupt 
addresses for each interrupting 
device, as in 
modes 0 and 2 on the Z80, is known as a vectored interrupt system. 


Now we must come to the specific details of interrupt service, and 
the obligations 
of the interrupt 
service routine. 
Just as the CPU 
hardware must acknowledge interrupts in such a way as not to dis- 
rupt the activity of the interrupted 
program, 
the interrupt 
service 
routine must do nothing to disrupt the interrupted 
program. 
Since 
the interrupt service routine uses the same registers as the program 
which is interrupted, 
it is the obligation of the interrupt service rou- 
tine to save and restore all registers and flags which it uses. Further it 
must remove or neutralize the source of the interrupt so that when 
the interrupt 
system is reenabled another interrupt 
from the same 
source does not occur. 
The great variety of possible interrupting 
devices makes specific 
discussion of arming sequences and interrupt source removal impos- 
sible. To include specific examples from the writer's system would 
only add confusion. A general approach will therefore be used to the 
examples which follow. Each of these has run on the writer's system, 
with the enabling and interrupt 
removal sequences appropriate 
to 
that system. The examples will be shown with the generally applica- 
ble service code intact, but with portions specific to this hardware 
configuration only indicated. 


We will consider first the simplest possible kind of interrupt situa- 
tion, that in which no data are to be transmitted. 
This type of inter- 
rupt occurs when the system is being used to count pulses from some 
source. The source may be external, as in counting cars entering an 
expressway ramp or shoppers breaking a photoelectric beam at a su- 
permarket entrance, or it may be internal, as in counting crystal or 
line frequency generated pulses for the purpose of keeping time. No 
data are transmitted in these cases. The data are the interrupts them- 


selves, the interrupt 
denoting 
the occurrence 
of some event. 
In this 
type of interrupt, 
the clearing 
of the flag which caused the interrupt 
is usually 
automatic, 
taking 
place as part 
of the interrupt 
acknow- 
ledge sequence. 
A device which generates 
a train of pulses, 
evenly spaced in time, 
is known 
as a real time clock. It is in no sense a clock, 
of course, 
since it does not keep time at all, but we will respect the common 
no- 
menclature 
here. If time is to be kept by such a device, the keeping of 
it is done in software 
by the interrupt 
service routine. 
A real time 
clock service routine 
is shown in example 
16-1. This example 
intro- 
duces new instructions. 
These instructions, 
their functions 
and mne- 
monics are: 


decrement 
the memory 
location 
pointed 
to by 
X plus the displacement 
d. The flags are set to 
reflect the result. The 
corresponding 
instruc- 
tion for Y is DCMY 
d 
stores the eight bit 
immediate 
operand 
n in 
the memory 
location 
pointed 
to by X plus the 
displacement 
d. The 
corresponding 
instruc- 
tion for Y is SlY 
d,n. 
The immediate 
operand 
n may be of any legal 8 
bit data type, for exam- 
ple, SIX 
1,'A' stores 
the ASCII code for the 
letter A into the mem- 
ory location 
one beyond 
that pointed 
to by X. 


The use of these instructions 
to keep a time of day clock under inter- 
rupt control 
is shown in example 
16-1. 


An external source is generating an interrupting 
pulse at 
120 Hz, twice the line frequency. The Z80 is operating in 
interrupt mode zero. The interrupting source will respond 
to the CPU acknowledgement 
of the interrupt with a re- 
start instruction which causes control to be forced to mem- 
ory location 8 (Restart 1). Presume that the device inter- 
face has already been armed and that locations 8,9 and A 
have been loaded with: 


Use the pulses to keep a software time of day clock. The 
clock cells are defined by: 


label 
PULSE 
ins!. 
DATA 
operand 
120 


SECOND DATA 
MINUTE DATA 
HOUR 
DATA 


number of interrupt 
pulses/ second 
seconds counter 
minute counter 
hour counter 


PUSH 
X 
LXI 
X,PULSE 


save A and the flags. 
These are the same flags 
and accumulator as are 
used by the program 
which was interrupted 
and must be saved and 
restored to avoid dis- 
rupting the interrupted 
program 
likewise for X 
address of pulse count 
toX 


DCMX 
0 
BNZ 
RETURN 


SIX 
0,120 
DCMX 
1 


BNZ 
RETURN 
SIX 
1,60 
DCMX 
2 


BNZ 
RETURN 
SIX 
2,60 
DCMX 
3 
BNZ 
RETURN 


SIX 
3,24 
RETURN 
POP 
X 
POP 
PSW 
EI 


decrement 
pulse count 
return if pulse count not 
yet zero 
reload pulse count 
decrement 
seconds 
count 
return 
if not yet zero 
reload seconds counter 
decrement 
minute 
counter 
return 
if not yet zero 
reload minutes 
counter 
decrement 
hour counter 


return if hours not yet 
zero 
reload hours counter 
restore X register 
restore 
flags 
REENABLE 
THE 
INTERRUPT 
SYSTEM!!!! 


The service routine 
shown 
presumes 
that 
the flag which caused 
the 
clock interrupt 
was reset automatically. 
If this is not true in your 
particular 
configuration, 
the instruction 
necessary 
to clear this flag 
must be included before the EI instruction is reached. Failure 
to at- 
tend to this will lead to an immediate 
and total disaster. 
When inter- 
rupts are enabled 
by the EI the same interrupt 
will be waiting 
again. 
The interrupt 
will occur again and the clock will again be increment- 
ed. The computer 
is thus forced 
into a kind of interrupt 
loop from 
which it cannot 
escape. 


The software 
clock kept by the above routine 
can be accessed 
for 
use by any other resident 
program 
by simply copying the contents 
of 
SECOND, 
MINUTE 
and HOUR, 
subtracting 
6010 from 
SECOND 
and MINUTE 
and 2410 from HOUR. 
The resulting 
binary time inter- 


vaIs can then be negated and converted to decimal for printing or 
other display. Note, they can be converted, not adjusted. Do not at- 
tempt to use DAA. It won't work. When copying the clock contents, 
the using program should disable interrupts for as long as required 
to make the copy. This is to prevent the clock changing during the 
copying process. If the clock reads 23 hours, 59 minutes, 59 seconds 
with a count of -1 in PULSE when a clock interrupt occurred the 
converted time would read 0 hours 59 minutes 59 seconds, nearly an 
hour wrong. 
Before leaving example 16-1, a note must be made about the EI in- 
struction. Suppose that the interrupt service routine in example 16-1 
were counting pulses which arrived at irregular intervals, rather than 
120 cycle pulse specified in the problem. The possibility now exists 
that a second pulse can arrive before the interrupt service routine has 
finished dealing with the first. If the enablement of interrupts 
oc- 
curred exactly when the EI instruction was executed the second inter- 
rupt would occur immediately after the EI, before the RET, Le., the 
address of the "interrupted 
program" 
would be within the interrupt 
service routine itself. This address would be pushed onto the stack 
and the interrupt service routine again executed. If no more pulses 
arrived the RET would pop the return address from the stack into 
the PC. This return address is none other than the address of the 
RET itself. The RET would again be executed and control would be 
returned to the program which was originally interrupted. 
This is 
fine and the return is orderly. Picture however, what would happen 
if any significant number of interrupting pulses arrived at this higher 
frequency. Return address after return address would be pushed on- 
to the stack before the computer had had the opportunity 
of dispos- 
ing of the earlier ones. This could cause a very mysterious stack ov- 
erflow. If the stack space were located between program segments 
the segment immediately below the stack space would suffer destruc- 
tion. If the stack were in lower memory so that the overflow crossed 
address zero, the popping of return addresses would bring the con- 
tents of upper memory into the PC, if such memory exists, effective- 
ly transferring 
control to some unpredictable 
location. 
If address 
:FFFF did not exist in the machine the effect would be to pop the 
contents of a nonexistent memory location into PC. This would usu- 
ally be all ones, and control would depart for that never-never land 
of nonexistent memory. 


There is a simple solution to this problem. When an EI is execut- 
ed, the enablement of the interrupt system is delayed until after the 
instruction which follows the EI has been completed. This instruc- 
tion would normally be the RET. This procedure insures that control 
at least reaches the program which was originally interrupted before 
another interrupt can occur. 
We turn now to another kind of interrupt situation, that in which 
data are to be transmitted. The interrupt in this case is simply a sig- 
nal that the device is ready to transmit data. The effect of arming the 
device interface for a data transmitting device is to connect the ready 
flag, the same one we tested by reading the status word and shifting 
into carry in programmed input! output, to the interrupt line. This 
allows a transition of the ready flag from the not ready to the ready 
state to cause an interrupt, Le., it completes the third of the three 
conditions for interrupt discussed before. Unlike the real time clock 
interrupt in example 16-1,however, the interrupt is not removed au- 
tomatically. Since it was the ready flag which caused the interrupt, 
this flag must somehow be cleared, Le., put into the not ready state. 
This removes the source of interrupt. This is done by the transmis- 
sion of data. In the case of input, the IN or other input instruction 
clears the flag to the not ready state. For output, the transmission of 
data from the CPU to the peripheral interface by an OUT or other 
output instruction clears the ready flag. The input case is the simpler 
and will be considered first. 


For terminal devices in general the input and output functions are 
considered separately, capable of being separately armed and dis- 
armed. In many ways a terminal can be considered as two distinct 
devices. Given that the arming sequence for the device has already 
been executed, and the interrupt system enabled by an EI, the strik- 
ing of a key will cause an interrupt. The data must then be read from 
the device to clear the ready flag. The basic sequence required for 
serviceof such an interrupt is shown in example 16-2. 


A terminal device connected to the Z80 has been wired so 
as to interrupt to location 2410 when a key is struck. This 
location and the two following it have been loaded with: 


Given that the interface has already been armed, write a 
program which will read four characters under interrupt 
control, storing them in successive locations beginning at 
NAME and set the flag at DONE to a one when the fourth 
character has been read. The operating program has al- 
ready executed the following subroutine: 


START 
ZAR 
STA 
DONE 
LXI 
H,NAME 


SHLD 
PTR 
MVI 
A,4 


STA 
COUNT 
RET 


PUSH 
H 
IN 
DATA 


clear DONE flag 
address of beginning of 
NAME block to HL 
save in pointer 
generate character 
count 


when the interrupt 
occurs control is trans- 
ferred first to location 
2410, then here by the 
JMP at that address. By 
the time the JMP is exe- 
cuted the interrupt sys- 
tem has been auto- 
matically disabled, just 
as if a DI instruction 
had been executed 
save AF and HL 
input from the terminal 
data address. This per- 
forms two functions. It 
brings the data into the 


ORI 
:80 
LHLD 
PTR 


INX 
H 
SHLD 
PTR 
LDA 
COUNT 
DCR 
A 
STA 
COUNT 


BNZ 
INSVC2 
MVI 
A,I 


STA 
DONE 
INSVC2 
POP 
H 
POP 
PSW 
EI 


DONE 
PTR 


A register and clears the 
ready flag in the ter- 
minal interface. 
It 
would be safe at this 
point to enable the in- 
terrupt 
system again, 
but we won't 
do this 
just yet. 
force high bit on 
get pointer 
which was 
initialized 
by the 
START routine 
above 
store the character 
just 
read 
increment 
the pointer 
replace pointer 
get character 
count 
decrement 
it 
replace count. 
Note that 
STA does not change 
the flags. 
skip if count not zero 
time to set DONE flag 
if count zero 
set flag 
restore HL 
restoreAF 
REENABLE 
THE 
INTERRUPT 
SYSTEM!!!! 
return 
to interrupted 
program 
block for storage 
of 4 
characters 
DONE flag 
space for temporary 
pointer 


space for character 
count 


Note that the interrupt 
service examples have saved the registers 
and status of the interrupted program on the stack. It has been sug- 
gested in some literature that the alternate registers be reserved for 
the use of interrupt 
service programs, 
saving the time required for 
the PUSHes and POPs. This will work, but is counterproductive 
since it deprives the operating program of the use of these registers, 
effectively reducing the Z80 most of the way back to the 8080. In ad- 
dition, it will not work for more than a single level of interrupts, pre- 
cluding the use of a priority system. 
The reader may have noticed by now that rather heavy emphasis is 
being laid on the reenablement of the interrupt system at the end of 
the interrupt service routine. This is because experience has shown 
that the failure to do so is one of the commonest of interrupt pro- 
gramming errors. Just why such a fuss should be made over inter- 
rupt 
programming 
errors 
in particular 
will become 
clear in a 
little bit. 


The case of output interrupts is a little subtler. Recalling the defi- 
nition of the ready condition, the state in which the device interface 
ready flag is true, if the output interrupt is armed, there will always 
be an interrupt pending when the device is idle. The only time no in- 
terrupt is pending is when the interface is busy processing a charac- 
ter. This requires a rather different approach to output interrupts. In 
general, the output interrupt must be kept disarmed when the inter- 
rupt system is enabled. It is armed only when data are to be transmit- 
ted and disarmed when the interrupt from the last transmitted word 
is received. This last interrupt must be dealt with and cannot be ig- 
nored as is suggested in some popular programming literature. To ig- 
nore this last interrupt in an output chain is to create the danger that 
the operating program will attempt to start another output chain be- 
fore the last character 
of the previous chain has been completed, 


causing both to be garbled. An interrupt driven terminal output rou- 
tine is shown in example 16-3. 


Presuming 
that 
two 
subroutines 
exist, 
ARM 
and 
DIS- 
ARM, 
which perform 
the arming 
and disarming 
functions 
for the terminal 
interface, 
create 
a string 
output 
routine 
which performs 
the same function 
as the PRT routine 
of 
example 
12-4, but under 
interrupt 
control. 
The routine 
is 
to be used by the operating 
program 
by loading 
the ad- 
dress 
of the 
first 
character 
of the 
string 
into 
HL 
and 
CALLing 
PRT. The string 
comes 
to an end when a car- 
riage 
return 
(:8D) is encountered 
as for the earlier 
PRT 
routine. 
Presume 
that the output 
interrupt 
is disarmed 
by 
a previous 
execution 
of DISARM 
when PRT is entered. 


label 
PRT 
inst. 
operand 
SHLD 
APTR 


EI 
RET 


enter here on call from 
operating 
program. 
Save 
pointer 
to 
first 
message character 
disable the interrupt 
system 
arm the output 
interrupt. 
With the in- 
terrupt 
system disabled 
nothing 
can happen 
now. Since the terminal 
output 
machinery 
is not 
occupied, 
however, 
the 
ready flag is in the true 
state, Le., the terminal 
is ready to accept data 
and an interrupt 
will oc- 
cur as soon as the sys- 
tem is enabled 
by EI 
enable the system 
and return. 
Since the 
actual enablement 
is de- 


PRTSVC 
PUSH 
H 
PUSH 
PSW 
LHLD 
APTR 
MOV 
A,M 
INX 
H 
CPI 
:8D 
BEQ 
EPSVC 
OUT 
DATA 


POP 
H 
EI 


layed until after the in- 
struction following the 
EI is finished, control 
will return to the point 
after the CALL to PRT 
in the operating pro- 
gram. Since all three 
conditions for interrupt 
are fulfilled, interrupts 
enabled, device armed, 
and ready flag true an 
interrupt will occur as 
soon as the RET has 
been completed 


saveHL 
saveAF 
get character pointer 
get character in string 
and increment pointer 
was it carriage return? 
skip if so 
otherwise send the 
character to the termi- 
nal data port 
save pointer for next 
pass 
restore the registers 
used 


REENABLE THE 
INTERRUPT 
SYSTEM!!! 


at this point the last 
character has been pro- 
cessed and the output 
interrupt must be dis- 
armed to prevent fur- 
ther meaningless inter- 
rupts caused by the now 
constant true state of 
the ready flag 
branch to common 
return 
space for address 
pointer 


Example 16-3 shows a procedure that will work if conditions guar- 
antee that no request for output will ever occur while an output 
string is in progress. Consider what would happen if the operating 
program called PRT while terminal output was in progress. The cur- 
rent value of APTR would simply be destroyed by the new one. The 
remainder of the message in progress would be chopped off and the 
new message started immediately. 
Clearly, this problem requires some solution. The solution is to 
create some kind of "lining" 
up queueing mechanism by which re- 
quests for output can be stacked up and serviced in an orderly way. 
In this case the interrupt service routine would be required to exam- 
ine the queue to see if any output requests were pending. If anything 
were waiting to be processed, the new string address would be pulled 
from the queue and the first character sent out, instead of disarming 
the output interrupt as was done in example 16-3. The problem be- 
comes a bit more complicated at this point. The general solution to it 
is not within the scope of the an elementary book like this. 
The overall task of keeping an orderly flow of work going through 
a system which is responding to random external world demand is 
far from simple. Programs which operate in this mode are said to be 
real time programs. 
For systems of any significant complexity the 
problem is usually solved by the creation of a program which man- 


ages the activities of application subprograms. A program capable 
of such management is known as a real time executive program. The 
structure of such a program will be the subject of a future volume in 
this series. 
There remains to be discussed a special interrupt, known as the 
nonmaskable interrupt. This interrupt is not under control of EI and 
DI but is always enabled and has ultimate priority over any other 
CPU activity. 
The use of this interrupt is usually reserved for some situation of 
more or less ultimate importance, a condition which cannot be ig- 
nored or deferred until other activities have been completed. In this 
category might fall such events as the onset of a power failure, the 
beginning of the battle of Armageddon or the start of the Monday 
night baseball game. The occurrence of the nonmaskable interrupt is 
deferred only until the instruction in progress has been completed. If 
another interrupt, one under EI/DI control is waiting, the nonmask- 
able interrupt is serviced first. Nothing has priority over it. The in- 
terrupt service routine for nonmaskable interrupt requires no special 
discussion here. The routine must do whatever is necessary to meet 
the condition warned of by the occurrence of the nonmaskable inter- 
rupt. Only one feature of this routine is different. The return to the 
interrupted program, if there is to be a return, is accomplished by the 
RETN instruction rather than RET. This is because the status of in- 
terrupt enable for normal interrupts is saved when the nonmaskable 
interrupt occurs. Use of RETN restores this status to whatever it was 
when the nonmaskable interrupt occurred. The use of EI before 
RETN is therefore superfluous. The enable state caused by the EI 
will be overridden by the action of the RETN. 
The Z80 has yet another mode of interrupt return, namely RETI. 
This instruction functions exactly like RET, but generates a pulse to 
the interrupting peripheral signifying that the interrupt service rou- 
tine has been completed. This is used in some special Zilog peripher- 
al configurations in which the peripheral interrupts are chained into 
a priority configuration, which allows peripherals of high priority to 
interrupt the service routines of lower priority peripherals. Creation 
of a system which uses this scheme should be approached with great 
caution and used only as a last resort if nothing else will work. The 
reason for this is obscure, but important enough that it needs explan- 
ation here. 


Imagine that there is a subroutine named SINEX located some- 


where in memory, which computes the trigonometric sine of an angle 
left in HL on entry. Such a subroutine is complicated enough that 
the necessary arithmetic cannot be done while holding all temporary 
results in registers. At one or more points intermediate results must 
be stored in memory. Suppose now that a level 3 interrupt 
occurs 
whose service requires the computation 
of a trigonometric sine. The 
interrupt service routine loads the angle into HL and executes: 


SINEX proceeds to begin the computation 
of the necessary sine and 
has stored some intermediate results, when a levell interrupt occurs. 
The level 1 interrupt service routine also requires that a sine be com- 
puted. This routine loads the angle into HL and executes: 


which proceeds to compute the sine required by the levell 
interrupt 
service routine, storing temporary results all the while into the same 
memory locations which were being used to compute the sine re- 
quired by the level 3 interrupt service. When the levell interrupt ser- 
vice routine has finished, it relinquishes control back to the level 3 
routine, in the middle of its sine computation. 
The result is garbage 
for the level 3 result, because its temporary 
results have been de- 
stroyed by the level 1 computation. 
This is a particularly nasty situation because, in general, it is never 
possible to recreate the exact circumstances under which the error 
occurred, a situation true of all interrupt related errors. The SINEX 
routine can be tested and retested with all possible input values and 
yield good results, but still give garbage while running because of the 
interference of the higher level interrupts. This situation has a name. 
It is known as the problem of reentrancy. 
There are two general approaches to the solution of this problem. 
The simplest one is to keep a copy of the SINEX routine for each lev- 
el of interrupt 
which might use it. This works, but is wasteful of 
memory. The second, and by far the subtler, is to write the SINEX 
routine in such a way that it will not be disturbed by being interrupt- 


ed in the middle of its execution. A routine written in this way is said 
to be reentrant. 
The creation of reentrant programs is no simple matter. Reentran- 
cy puts an overhead burden on the program which will very likely 
cancel any advantage which might accrue to its use. In general, the 
working programmer who is required to produce a result will find it 
most productive to find ways of avoiding reentrant situations rather 
than solving the problems associated with them. For this reason the 
writer recommends that the use of this type of priority interrupt sys- 
tem be avoided whenever possible, and approached 
only with great 
care and caution after the programmer 
has built up his experience 
with simpler types of interrupt systems. 
Returning now to the general subject of interrupt service program- 
ming, there are three general categories into which most interrupt 
programming errors fall. They are: 


1) Failing to save and restore the status of the interrupted program. 
This causes chaos in the interrupted program, since registers ap- 
pear to change value as if by magic. 


2) 
Failing to reenable the interrupt system at the end of interrupt 
service. This assures that the interrupt service routine will be exe- 
cuted once and only once. This one is fairly obvious from the 
symptoms. 
A real time clock routine will increment the pulse 
count only once, for example. 


3) 
Failing to remove the source of interrupt, 
Le., the ready flag 
which caused it. This puts the computer into an interrupt loop 
from which it can never recover. This is also fairly obvious and 
should be suspected if the computer is stopped repeatedly and 
the PC always contains an address within the interrupt 
service 
routine. 


In finding errors in a noninterrupt 
environment it is always possi- 
ble to trace through the program, one instruction at a time if neces- 
sary, or by the methods to be detailed in chapter 17,until the offend- 
ing instruction 
or sequence of instructions 
is located. The process 
can be accompanied by much misery and suffering, but it is always 
possible. With errors caused by faulty interrupt service, however, it 


is not in general possible to recreate the situation which caused the 
error. Interrupts occur at points which are random with respect to 
the operating program. This writer has experienced a real time sys- 
tem which ran for 3 months, 24 hours per day, before showing the 
error. It did not appear again for another 6 months. Needless to say, 
such an error is maddening to track down. The best approach to the 
entire problem is to be exceedingly careful in writing interrupt ser- 
vice routines. Test the routines for function outside the operating 
program environment with tests designed in such a way that if an er- 
ror occurs it can be localized easily. But mainly, be very, very careful 
with the original programming. 
Finally, there is the matter of the interrupt instruction supplied by 
the peripheral interface during mode 0 interrupt operations. These 
instructions, known as restarts, are also available to the programmer 
and can be written in line in the program. Executed under these cir- 
cumstances they do not cause the interrupt system to be disabled. 
They can be written in the assembly language using either of two 
synonymous mnemonics, RST or TRP. The TRP means trap, which 
is more suggestive of their real function than restart. RST and TRP 
require an operand in the 0 - 7 range. When the RST or TRP is exe- 
cuted control is sent to the address specified in the operand, multi- 
plied by 8. Thus: 


sends control to location 5610, or 3816• The PC is pushed onto the 
stack by execution of RST or TRP, just as during interrupt operation 
or a CALL. A use for these instructions will be illustrated in chapter 
17.An example of the use of in line TRP instructions as CALLs is in 
the bootstrap loader in appendix A. 


17 I 
PROGRAM 
DEBUGGING 
TECHNIQUES 


"There is no mistake; 
there has been no mistake; 
and there shall be no mistake?' 


Arthur Wellesly 
Duke of Wellington 


When, 
at long last, the processes 
of program 
writing, 
desk check- 
ing and assembly 
have been completed 
there 
remains 
only the pro- 
cess of trying 
out the product. 
Perhaps 
the word only implies 
a too 
casual 
attitude 
toward 
a process 
which 
may well be lengthier 
and 
more painful 
than the creation 
of the original 
program. 
The final step of the assembly 
process 
is the production 
of the ob- 
ject program. 
Object 
output 
is produced 
by our assembler 
by means 
of the #0. command. 
When this command 
is issued the assembler 
re- 
plies with: 


The system then waits for the punch 
to be turned 
on and the space 
bar to be struck. 
The object program, 
a binary 
version 
of the source 
program 
suitable 
for loading 
into 
the Z80 system 
and running, 
is 
produced. 
The object 
program 
is preceded 
and followed 
by several 
inches of blank tape. When the punching 
is finished the system again 
pauses waiting 
for the space bar to be tapped. 
When the space bar is 
struck the prompt 
character 
(» 
appears. 
The loading 
of the object 
program 
and the supervision 
of its exe- 
cution is performed 
under control 
of a program 
called the debugging 
monitor or debug for short. 
The full source text of this program 
as 
well as the directions 
for initializing 
it for particular 
configurations 
of peripherals 
are given in appendix 
C. If you have not already 
per- 
formed 
this initialization 
for your system, go to appendix 
A now and 


do it, since you cannot proceed with the work of this chapter until 
this is done. 
This debug program, needing a name, was dubbed ZEDBUG. The 
most natural 
name for a Z80 debug program 
would have been 
ZBUG or ZEBUG, but the literature already contains references to 
those names, so the program was named ZED BUG after the Europe- 
an manner of pronouncing the letter Z, even at the risk of the name 
being confused with that of certain disagreeable creatures which in- 
habit cheap hotels. 
ZED BUG is entered by setting the PC of your system to its begin- 
ning location, 
360016 as given in the appendix. 
This can easily be 
changed by transcribing the listing and reassembling for any desired 
origin. When entered, ZEDBUG immediately produces the pound 
sign (#) as a prompt character. This means that it is ready to accept a 
command. To load the object tape produced by the assembler type 
an L followed by a period. The transaction looks like this: 


If your system has paper tape reader control the object tape will slew 
through the reader and stop, ZED BUG producing another prompt 
character at the end. The object tape produced by the assembler con- 
tains certain validity checking data known as a checksum. 
This 
checksum 
is calculated 
by the assembler 
as the object 
tape is 
punched, and punched as the last frame of each tape record. When 
the object tape is read by the loader in ZED BUG this checksum is re- 
calculated and compared with the checksum on the tape. If the two 
are not identical the loader warns the user of the error by typing: 


and returning control to ZEDBUG. If this happens make sure that 
the tape read mechanism is clean and functional. Photoelectric read- 
ers in particular are sensitive to small specks of material in the read 
mechanism. 
After you have blown out the dust, dead insects and 
other debris from the reader try again. If you still get the CKSM 
message the tape is probably bad. Make another one and try again. 


When the object program has finally been loaded, ZEDBUG will 
again respond with a prompt character. 
Its facilities may now be 


used to examine the program in memory. The contents of a memory 
location or group of locations may be displayed on the terminal by 
using the M command, followed by the desired address, followed by 
a period. Suppose the program in example 9-5 had been assembled 
with an origin of :lDOO and loaded. The assembly listing for this 
program is shown below. 


002 
l'l03 
004 
005 
1306 }[>00 
F5 
087' 
IDOl 
E5 
008 
ID02 
C5 
00.9 
ID03 
D5 
8/0 
IN34 54 
011 
ID85 
5D 
012 
1006 
13 
013 
ID07' 
08 
014 
1D8S n 
015 
IDO.9 ED80 
l'l/6 
ID08 
DI 
017 
IDOC CI 
018 
IDOD E I 
01.9 
IDOE FI 
020 
IDOF 
021 
10/2 


ORG 
: JOO!? 
* FILL 
f'1ENOR'r'AREA. 
1ST ADDRESS IN HL 


:I< 
COUNT IN 
8C .. FILL 
CHRR IN 
ft. 
RETUPN 
* NITH 
NO 
DISTUR8ED 
REGISTERS 
FILL 
PUSH 
PSN 
PUSH 
H 
PUSH 
8 
PUSH 
D 
MOil 
O.•H 
MOil 
E..L 
INX 
D 
DCX 
8 
/'lOll 
M,R 
$ 
NN+R 
POP 
D 
POP 
8 
POP 
H 
POP 
PSN 
RES 
3 
END 


*************************** 
* S Y M 8 0 L 
T R 8 L E * 
*************************** 


Executing the M command followed by the address IDOOwould type 
out the contents. This is shown below, with the parts typed by ZED- 
BUG underlined, 
and those typed by the user not underlined. 
The 
symbol @ will be used in places where the user types a blank. The ex- 
amination of location IDOOis accomplished by: 


# MIDOO. 


IDOO F5 


ZEDBUG 
then waits for a response from the user. If a hexadecimal 
number is typed the contents of the memory location just printed out 
will be replaced with what was typed. To change the contents of loca- 
tion IDOO from the F5 to an E7, just type E7 after ZED BUG prints 
the F5. The transaction now looks like this: 


# MIDOO. 


IDOO F5 E7 


If any non-hexadecimal 
character is typed as replacement contents 
the command will be immediately aborted with a question mark and 
the contents of the location will be unchanged. If a mistake is made 
in typing, say E8 instead of the desired E7, just keep typing. Only the 
last two characters count. If the contents are not to be changed and 
no further examination is to be done, type a period. This will result 
in a prompt character and ZEDBUG 
is ready for another command. 


If examination of the next high location is desired, type blank and 
the address and contents of the next location will be typed. This may 
be carried out to any length. The first 5 locations of the program can 
be examined and/or modified by: 


# MIDOO. 


IDOO F5 
@ 


IDOl 
E5 
@ 


ID02 
C5 
@ 


ID03 
D5 
@ 


ID04 
54 


# 


Again, the @ signifies a blank typed by the user. The period typed in 
the last line terminated the M command. The blank typed after each 
preceding line caused the examined address to be incremented. The 
examined address may also be decremented by responding with a 
comma instead of a blank. Locations ID04 through IDOO are exam- 
ined by: 


# MlD04 


lD04 54 


lD03 D5 


lD02 C5 


IDOl E5 


lDOO F5 


# 


The use of comma instead of blank decremented the examined ad- 
dress instead of incrementing it. In all cases, if a hexadecimal num- 
ber had been typed in before the blank, comma or period, the con- 
tents of the memory location currently being examined would have 
been replaced with the typed number. 
The M command has been used above to examine locations one at 
a time. If an entire block of memory is to be examined, it can be 
printed out in blocks of 16 words by using the M command with two 
addresses instead of one. The entire program of example 9-5 is print- 
ed out by: 


lD00 
F5 E5 C5 D5 54 5D 13 03 77 ED 80 D1 C1 E1 Fl 08 


1D10 
FA 
6E 


# 


Le., the entire block is printed by ZED BUG (not underlined here). A 
block of any length may be printed in this way. If the second address 
typed is less than the first ZEDBUG will reply with a question mark 
and ignore the command. 
A similar "dumping" 
function may be performed by the D com- 


mand. Using D instead of M punches the block of memory onto pa- 
per tape in a format which can be reloaded by the L command. This 
is extremely useful when patching a program in binary. It allows the 
corrected 
program 
to be dumped onto paper tape in reloadable 


form. This permits the programmer to make a number of correc- 
tions before being forced to go back to source level to update the 
program, a considerable economy in debugging. The D command 
pauses after the period is struck to allow the tape punch to be turned 
on. The space bar is then struck and the punching, preceded and fol- 
lowed by several inches of blank tape, proceeds, followed by another 
pause for the space bar at the end. The spaces are not punched onto 
the tape. 
Other memory operations performed by ZEDBUG are the fill and 
search functions. A block of memory may be filled with a value by 
the F command, followed by the first and last address to be filled, 
and the value. The command: 


fills the block which begins at :87 and ends at :FA with the value 
:EB. This is useful when a block must be initialized to some constant 
value. A memory block may be searched for some value by the S 
command, followed by the limits of the block and the value to be 
searched for. The program in example 9-5 could be searched for the 
value 77 by: 


ID08 


# 


The ID08 being the address at which the value 77 was found. If this 
value had appeared more than once in the block each address at 
which it was found would have been logged. The S, D, or M com- 
mands may be terminated at any time by holding down the control 
key and pressing the C key simultaneously. 
Two more commands will be considered here before proceeding to 
the main business of debugging programs. When testing peripheral 
devices it is often handy to be able to transmit single words to and 
from them. The I command allows input from the peripheral device. 


address which follows it, the result being printed on the next line. 
The command: 


# 121. 


B1 


results in I/O address 2116 being read and printed. The result, a B1 in 
this hypothetical case, is followed by a response from the user. If the 
response is a period the command terminated. If a blank is typed the 
operation is repeated. Data may thus be repeatedly read from a per- 
ipheral under test. 
The 0 ("oh", 
not zero) command followed by an I/O address, a 
blank, and a hexadecimal number sends the number to the I/O ad- 
dress indicated. The command: 


sends the number FF 16 to device address 2l. 


In all cases of ZEDBUG commands, 
leading zeros may be omit- 
ted. They do no harm if typed, but will have no effect. Also in all 
cases, an error may be corrected by simply retyping the number with 
the necessary number of digits. This holds for 4 digit addresses (and 
later for register pair contents) and for two digit memory location 
contents. 
A command will be aborted if anything but a legal re- 
sponse is received from the keyboard. 
Having established the ground rules and examined some of the mi- 
nor functions of ZEDBUG, we can now proceed to the real business 
of this chapter - 
program debugging. ZEDBUG contains a number 
of pseudo registers which correspond one-for-one with the real regis- 
ters of the Z80. These pseudoregisters may be displayed and modi- 
fied much as memory locations have been modified in the previous 
examples of this chapter. All access to the pseudoregisters is via the 
R command. The command: 


304 
PRACTICAL MICROCOMPUTER PROGRAMMING 


BC 
DE 
HL 
A 
S 
Z - 
A - 
V 
N C 
0000 0000 
0000 
00 
0 0 
0 
0 
0 0 
'0000 0000 
0000 
00 
0 
0 
0 
0 


"" 
"" 
X 
Y 
SP 
DIFF 
0080 0000 
0000 
000'~ 


# 


which displays the status of all of the ZEDBUG pseudoregisters. The 
above display shows the status of the pseudoregisters when ZED- 
BUG is initially loaded, i.e. they are all zero. 
This looks more complicated than it really is, so we'll take it one 
step at a time. The top line of the typeout shows the status of the 
principal register set, BC, DE, HL, A and F. BC, DE and HL are al- 
ways treated as pairs, while A and F are handled individually. The 
bits of the F register are spread out for easy viewing. The second line 
of the typeout is the content of the alternate register set, the one you 
can access after executing EXX and XAF instructions. This is indi- 
cated by the apostrophe or prime mark at the left end of the line. The 
bottom line shows the contents of the pseudo X, pseudo Y and pseu- 
do stack pointer. The meaning of DIFF will be passed over for the 
moment. A pseudoregister or pseudoregister pair is individually ex- 
amined or set by typing the R command, then the register name, then 
a blank. For register pairs BC, DE and HL only the name of the left- 
most register is used. The name F is used for the flag register. The 
contents of pseudo HL can be examined and modified just like a 
memory location. The command: 


ZEDBUG then waits for a response if a period is typed nothing is 
changed and a prompt character appears again. If a hexadecimal 
value is typed, the value of the pseudoregister or pair is replaced with 
that value. The HL pair is set to the value 7B2F16 by: 


The command must be terminated with a period or the replacement 
does not take place, the only result being a question mark and anoth- 
er prompt. The BC and DE pairs are set similarly. Remember when 
setting a register pair that both registers must be set. In the case of A 
only two digits need by typed, or one if the leftmost is a zero. Pseudo 
A register is set to the value 3 by: 


A leading zero before the three would have done no harm. It is un- 
necessary, however. If both of the above changes are made and the 
R. command used again, the result is: 


BC 
DE 
HL 
A 
S 
Z - 
A - 
V 
N C 


vH'J000000 
7B2F 
03 
0 0 
0 
CO 
0 
0 


'0000 
~~00 
0000 
00 
(0 
0 
0 
~j 0 
0 


X 
Y 
SP 
DIFF 


0080 
0000 
0000 
0000 
# 


The bits of the pseudo F register are set individually. 
The com- 
mand !LRF@ produces the following display: 


SZ-A-VN 
C 
o· 0 
0 
0 0 
0 


ZEDBUG then pauses waiting for a keyboard response. If the name 
of one of the flag bits is typed, followed by a I or a 0, the flag value 
is replaced by the typed value, ZED BUG types one space, and waits 
for the name of another flag. This may be continued until all the 
flags have been set to their desired values. The setting of the S, A and 
C flags is accomplished by: 


# RF@ 


SZ-A-VN 
C 
------- 
- 
o 0 
0 
0 0 0 
Sl 
Al 
Cl. 


The flag settings need not be done in left to right order as shown 
here. After the above has been typed in, anotherJL RF@ command 
will yield: 


SZ-A-VN 
C 
1 0 
1 
001 


The alternate pseudoregisters (i.e., the prime registers) are set and 
manipulated exactly like the principal registers except than an apos- 
trophe is typed after the register name instead of the blank (@ in our 
displays here). The command: 


with the value of BC' being set to 03F816• With this change an R. 
command yields: 


BC 
DE 
HL 
A 
S 
Z - 
A - 
V 
N C 


0000 
0000 
7B2F 
03 
1 
0 
1 
", 
(1 
1 
tl?J3F8o Cj(!) (I) 
0000 
("'H3 
0 
0 
(0 
0 
0 
0 
X 
Y 
SP 
DIFF 


0080 
0000 
0000 
0vj(~0 


showing the cumulative changes which have been made. The X, Y 
and SP pseudoregisters are set in exactly the same way as the other 
pseudoregister pairs, SP being addressed as S. 
The best way to become familiar with all of these mechanics is to 
exercise your knowledge. At this point it will be well worth your 
while to abandon reading for a while and tryout 
the things which 
have been discussed so far in this chapter. When you are comforta- 
ble with the loading process, the examination and inspection of 
memory and the setting of the pseudoregisters come back here and 
we will proceed. 


Example 17-1shows the assembly listing of a program which is to 
convert the fraction in the A register to ASCII-decimal, leaving the 
result, beginning with a decimal point, in the five word area whose 
lowest address is contained in X on entry. The example contains de- 
liberate mistakes which we will find and correct using ZEDBUG. 
The object tape is loaded into memory using the L command, and 
the presence of the program verified by printing it out with the M 
command, i.e.: 


ffY',1E00 
I E2A. 
In~0 
DO 
311 on 
AE 
DO ?3 
,~'" 04 or 
26 uo 29 
SLj 
5D 29 
2'i 
IEI~ 
09 
JE 
~H1 i3Lj 
DO 
77 00 DD 23 
1(1 r.r" 
C9 
DlJ 
21 
26 
I I' 


IE20 
CD 
00 
IF. 
HI' 
1'13 
E9 
Dr 
iJD 
1'1 
9~ 
FB 


Do not omit this precaution. Always check that the program has 
been loaded, at least in a few places if not the entire program. This 
can save you from some mysterious situations. 
The program will be executed under the control of ZEDBUG by 
means of a procedure called breakpointing. 
Breakpointing is the 
most powerful single debugging tool you have, at least in conven- 
tional programming systems, so learn to use it intelligently. It is not 
without its drawbacks, but it offers a faster route to the finished, 
working program than any other procedure. The effort you put into 
understanding breakpointing will repay itself very quickly. 


082 
003 
IEOO DD3600AE 
$ CSF 
084 
IE84 DD23 
$ 
885 
IE86 0604 
l~06 IE88 6F 
OO? 
/E09 2600 
CSFI 


808 
IEl~829 


809 
IEac 54 


1318 IEOD 50 
811 
IEOE 29 
l~/2 IEOF 29 
813 
IEI13a9 
014 
IE /I 3E80 
815 
IE/3 84 


0/6 
IEI4 007?88 
$ 
Ol? 
/E17 0023 
$ 


ORG 
'IEOl~ 
SIX 
'3,'" 


INX 
X 


MVI 
8,4 
MOV 
L.,A 
MVI 
H.0 


DAD 
H 


MOV 
O,H 


1'101' 
E,L 
DAD 
H 
DAD 
II 


DAD 
8 


1'11'1 
A, "8' 


ORA 
H 


SAX 
0 
INX 
X 


PLACE 
DECIMAL 
POINT 


INCRENENT 
POINTER 
DIGIT 
COUNT 
TO 8 
NOVE FRACTION 
TO L 


CLEAR 
INTEGER 
SPACE 


NUL TIPLY BY 
TWO 


SAVE 
IN DE 


TINES FOUR 
TINES EIGHT 
ADD PREVIOUS 
RESULT 
GET 
"FRANE" FOR ASCI I DIGIT 
MERGE 
WITH BCD DIGIT 
STORE 
IN STRING 
INCRENENT 
STORE 
POINTER 


8/8 
/E/9 
/8EE 
$ 
D8NZ 
CSFI 
DECREHENT 
COUNT 
819 
IE/8 C9 
RET 
DONE 
'''HENCOUNT 
ZERO 
828 
82/ 
TEST CODE 
FOR 
CSF 
a22 
823 
IEIC DD21261E 
$ TCSF 
LXI 
X,N 
824 
IE28 CD881E 
CRLL 
CSF 
025 
IE23 
RES 
3 
SPRCE 
FOR 8RERKPOINT 
fJ26 
IE26 
N 
RES 
5 


. @27 
/E28 
ENO 


*************************** 
..•S 'r' H 8 0 L 
T R 8 L E ..• 


*************************** 


CSF 
IE88 
CSFI 
IE89 
N 
IE26 
TCSF 
JEIC 


Breakpointing is a controlled execution of part of the program be- 
ing tested. When a breakpoint is executed, three words of the pro- 
gram being tested are replaced by a JMP instruction, which will re- 
turn control to ZEDBUG when that point is reached. Looking at the 
program of example 17-1,the test code begins at location :1E1C with 
the loading of the X register and ends at :1E23. The RES 
3 at this 
location is simply allowance for the JMP instruction which will be 
inserted by ZEDBUG. We want to begin execution at address :IE1C 
and return to ZEDBUG when control reaches :1E23. This can be ac- 
complished by the command: 


But don't be too hasty and try this prematurely. There is the ques- 
tion of how to get the number which is to be converted into A. The 
answer is quite simple. Those pseudoregisters we spent so much time 
on a little while ago are loaded into the real registers before ZED- 
BUG executes the jump to :1EIC. All machine registers are loaded 
from their pseudoregister counterparts before the jump, so that the 
real register status as the program begins execution is exactly that 
which was specified by the pseudoregisters in ZEDBUG. We there- 
fore set the pseudo A register to the required test value. For testing a 
fraction converter the value .7510 is a good place to start, so we type: 


This replaces the former value of pseudo A, a 3, with the value C016 
which is .75 with the point all the way to the left. We now try the 
breakpoint by typing: 


and nothing happens. Nothing at all. When the machine is stopped 
the program counter is nowhere near the program being tested. It 
may even be in nonexistent memory. The first thing to do is set the 
PC back to the beginning of ZEDBUG and start the computer. This 
will restore the three program words which were replaced by the 
breakpoint and get the program back to its original condition. May- 
be. Because the program ran out of control there is no way to know 
what damage may have been done by the random execution of in- 
structions which took place. If ZEDBUG does not respond when it is 
restarted, then ZEDBUG itself has been destroyed. It will be neces- 
sary to reload both it and the program to be tested. If ZEDBUG 
responds, count yourself lucky. This dumb error did not do any seri- 
ous damage. Let's figure out what the error was. 
Recall that all machine registers are loaded from their pseudo 
counterparts before the JMP from ZEDBUG to the beginning execu- 
tion address, :1E1C in this case. This means all registers, including 
the stack pointer. Not having bothered to set the pseudo stack point- 
er, it was zero at the time of the jump. Since the second executed in- 
struction is a CALL, this pushed the PC into imaginary memory (on 
a system with less than 64K RAM). The subroutine mayor may not 
have executed in this case, but when the RET at 1E1Bwas encount- 
ered, nonsense was popped into the PC from this imaginary memory 
space. The program counter then departed for some unpredictable 
place, "Gumbiland", 
as Mr. Frank Horne is fond of calling it. We 
have committed the commonest error in all microcomputer pro- 
gramming, forgetting to load the stack pointer. 
We could at this point go back to the source program and insert 
the necessary LXI 
SP instruction, but ZEDBUG offers an easier 
way out. Set the pseudo stack pointer to some acceptable value so we 
can try again. Suppose the space below :100 were not in use. The 
stack can be set to this value by: 


After again setting pseudo A to CO(necessary if ZED BUG had to be 
reloaded) we try the breakpoint again. 


'·H<PT 
REACHED 
AT 
1E23 
BC 
DE 
HL 
A 
S 
Z - 
A - 
V 
N 
C 
0000 
0000 
0100 
Bl 
1 
0 
0 
1 0 
0 
t03F 8 
0000 
0000 
00 
0 
0 
0 
0 
0 
(1 
X 
Y 
SP 
DIFF 
1E~B 
0000 
010'-."0000 


At least this time something happened. 
Exactly what happened is 
this. A JMP instruction 
leading back to ZEDBUG was placed in 
:lE23 and the following two words, the former contents of these 
words being saved within ZEDBUG. The Z80's registers were then 
loaded from the pseudoregisters and a JMP 
:1EIC from ZEDBUG 
was executed. The program then executed. When control reached the 
JMP which ZED BUG had placed at :lE23 and the two following 
words, the JMP was executed. Upon rear rival in ZED BUG the ma- 
chine registers are stored into their pseudo counterparts 
and the 
three words beginning at :lE23 are replaced with their original pre- 
breakpoint values. Everything looks fine up to here. 
There remains only the question of whether the thing produced the 
right answer. The correct conversion of :CO should be .7500, since 
the routine cut_soff conversion after 4 decimal digits have been gen- 
erated. The ASCII for .7500 should be AE B7 B5 BOBO,the AE be- 
ing the ASCII for the decimal point. We test this by printing out the 
result area beginning at N, location :lE26. 


# f¥' 1E2 h 
1E2 A • 
lE26 
AE BA 83 
82 31 


Garbage. 
The converter doesn't 
work. Outside of the AE for the 
point, not a single character is correct. 


To find the problem we will have to step through the routine in 
smaller increments, checking for correct results at each stage. We be- 
gin by resetting pseudo A to CO, as before and executing only the 
portion of the program from lE1C to lE09, Le., the LXI', the CALL 
and the first four instruction of the subroutine. 


IRA 
B1 
C0. 
#B 1E 1C 
1~(19 • 


I3XPT :iEACHED 
AT 
1E09 
BC 
DE 
HL 
A 
S l - A - 
V 
N C 
0400 00fJ0 
01C0 
C0 
1 
0 
'3 
1 0 
0 
'03FR 
000(1 0000 
00 
(1 
V} 
0 
0 
vI 
0 


X 
Y 
SP 
DHr 
1E27 
0000 
00FE 
FFFF: 


Now look at this partial result. The digit count, a 4, is properly 
placed in B. A has been copied to L and the stack pointer now reads 
FE instead of 100. This difference in the stack pointer was caused by 
the pushing of the PC during the CALL 
CSF. Note the DIFF col- 
umn. It displays the number FFFE. This is the difference between 
the stack pointer values when the breakpoint was entered and when 
control returned to ZEDBUG. This is of no particular significance 
here but this information 
can be of great value when debugging pro- 
grams which make strenuous use of the stack. It is a means of telling 
at any time whether the proper number of pushes and pops has been 
executed. Now let's execute the next instruction. To do this it will on- 
ly be necessary to type one address. If only one address is given, the 
breakpoint facility will use the return point from the previous break- 
point as its jump address. If there was no previous breakpoint ZED- 
BUG will give you a nasty message. To resume execution at 1E09 and 
stop at lEOB, we need only type: 
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BKPT 
REACHED 
AT 
1E:~B 
Be 
DE 
HL 
A 
S l - A - 
V 
N 
C 
040v) 
0'100 00C0 
C0 
1 0 
0 
1 0 
0 
'03F8 
0000 
0000 
0(1 
0 
0 
0 
0 
0 
0 
>. 
y 
SP 
DIFF 
1E27 
0000 
00FE 
0000 


To this point, everything looks proper. The H register has been 
cleared to zero. Now let's try the first left shift and copy to DE. 


fB1E0E. 
BKPT 
REACHED 
AT 
lE0E. 


BC 
DE 
HL 
A 
S l - A - 
V 
N 
C 
04(10 0180 
0180 
C0 
1 0 
(3 
1 0 
Ql 
'03F8 
0000 
0000 
00 
0 0 
0 
0 
0 
0 
X 
Y 
SP 
DIFF 
lE27 
0000 
00FE 
0000 


Again, this looks OK. The CO in HL has been properly shifted left to 
get 0180 and this has been copied into DE. In case it hasn't become 
obvious by now, the breakpoint is executed up to but not including 
the named address, Le., the last instruction executed in this break- 
point was the MOV 
E,L at lEOD. The DAD 
Hat 
lEOE was not 
executed. The second address names the lqcation at which the return 
should occur. So far so good, now we'll try the next two left shifts. 


#BIEI0. 
BKPT 
REACHED 
AT 
lE10 
BC 
DE 
HL 
A 
S 
Z - A - 
V 
N C 
0400 
0180 
0600 
C0 
1 0 
0 
1 0 
0 
'03F8 
0000 
0000 
00 
0 0 
0 
0 
0 0 
X 
Y 
SP 
DIFF 
lE27 
0000 
00FE 
0000 


Again the result looks correct. The 6 in the H register is the correct 
result of shifting OOCO in HL left three places, and the copy of the 
doubled original number is still in DE. Now we execute one more 
instruction. 


181Ell. 
8KPT 
REACHED 
AT 
1Ell 
8C 
DE 
HL 
A 
5 
Z 
- A 
- 
V 
N C 
0400 
0180 
0A00 
C0 
1 0 
0 
1 0 0 
'03F8 
0000 
0000 
00 
0 
0 
0 
0 0 
0 
X 
y 
SP 
DIFF 
1E27 
0000 
00FE 
0000 


and it's all. wrong. 
Since the first digit generated 
had to be a 7 if the 
value of the original 
fraction 
was .75, the A which has appeared 
in H 
is wrong. 
Looking 
at the assembly 
listing 
quickly 
reveals the prob- 
lem. We are adding 
the wrong 
register 
pair to HL. The result of the 
first left shift was saved in DE, but we are adding 
BC. This kind of 
error is common 
enough when transcribing 
the written 
program. 
The 
question 
is how to fix it. 


The most obvious 
way is to go back to the source level and correct 
the original 
program. 
This works, 
of course, 
but takes 
some time, 
particularly 
if the listing device is slow. This has to be done eventual- 
ly, but it would be better to find some way to patch the error tempo- 
rarily so we can proceed 
with testing the program. 
If any more errors 
are found they can all be fixed at once in the source program 
and on- 
ly one listing pass made instead 
of several. 
With the aid of the M command, 
the offending 
instruction 
can be 
changed. 
From appendix 
D we find that 
the hexadecimal 
configura- 
tion of a DAD 
D instruction 
is 19. The patch is made by: 


# M1ElO. 


1E1O 
09 
19. 


The A register 
is now reset to its original 
value, 
CO, and the pro- 
gram run again: 


IRA 
C0 . 
fB1E1C 
lE23. 
BKPT 
REACHED 
AT 
1E23 
BC 
DE 
HL 
A 
5 
Z - A - 
V 
N C 
0000 0000 
0000 
B0 
1 0 
0 
0 0 " 
'03F8 
0000 
0000 
00 
0 
0 
0 
0 
0 0 
X 
'( 
SP 
DlF·F 
lE28 
0000 
0eFE 
0000 


# M1E26 
lE2A. 
1E26 
AE B7 B5 BO BO 


# 


and found to be correct, .7500. With this result correct, we can 
breakpoint through the program with other test values to verify its 
correct performance under all circumstances. Note that the stack' 
pointer reads OOFEin this last breakpoint report. It would be of val- 
ue for the reader to trace back through what has been done to find 
out why this is so. 


We cannot leave this discussion of breakpointing without pointing 
out some cautions that must be observed. First, it must be obvious 
by now that both of the breakpoint addresses must be the locations 
of the first word of an instruction. If this is not so either the JMP 
from ZEDBUG will land in the middle of the instruction or the 
breakpoint return will not be executed. If control does not return to 
ZEDBUG, from this circumstance or any other, stop the computer, 
set the PC to the beginning of ZEDBUG and start it again. This will 
insure that the three words replaced by the breakpoint return JMP 
will be restored. 
Note also that the breakpoint return instruction requires three 
words. This means that breakpoints must be carefully placed. If a 
breakpoint had been attempted from the LXI 
X,N at 1ElC to the 
RET at 1ElB the last two words of the return JMP would have over- 
laid the first two words of the LXI, leading to disaster. 
The error patching case covered above is a simple one, the replace- 
ment of a one word instruction with another one word instruction. If 
an instruction needs to be removed, the fix is even'simpler. Just use 
the M command to set the offending instruction to zeros. Make sure 
you set all of it to zero, if it is a multiword instruction. The case of 
the missing instruction is a bit harder. 
If the patch requires that an instruction of one or two words be re- 
placed by one of two or three words, or if an instruction has been 
omitted, another procedure is used. The point at which the instruc- 
tion must be inserted is replaced with one of the restart instructions 
to which no interrupt is attached. These instructions are: 


C7 
traps to 0 
CF 
traps to 8 
D7 
traps to 16 
DF 
traps to 24 
E7 
traps to 32 
EF 
traps to 40 
F7 
traps to 48 
FF 
traps to 56 


If the instruction 
replaced by the restart is more than one word 
long set the remaining words to zero. At the trap location the effect 
of the replaced instruction must be duplicated, followed by the in- 
struction which is to be inserted. The last instruction 
of the patch 
must be a :C9, which is a RET. 
There are three last features of ZED BUG which must be covered, 
namely the J and Slash (/) commands and the stack examination fea- 
ture. J means a simple jump after loading the Z80's registers with the 
contents of the pseudoregisters. It is something like a breakpoint, 
ex- 
cept that control does not return to ZEDBUG. The J accomplishes a 
simple transfer of control to the program to be executed. Needless to 
say, it is only used when a good deal of confidence has been built up 
in the program to be run. J accepts only a single address and termin- 
ates with a period. 
The slash command controls the enablement of interrupts during 
breakpoints and jumps. The command: 


will result in the interrupt system being disabled before a breakpoint 
or jump, while: 


results in breakpoints 
and jumps 
being executed with interrupts 
enabled. 
The contents of the stack may be examined directly by using the 
M command followed by the letter S and a period. This command 
fetches and prints the word pointed to by the pseudo stack pointer, 


and the word at the next higher address, i.e., the last item pushed 
onto the stack by the user program. This is useful when breakpoint- 
ing into a subroutine since it displays the address of the calling point. 
It is further useful at the end of the subroutine to insure that the cor- 
rect return address has been placed in the right stack position. Typ- 
ing space displays the item previously pushed, i.e., displays the item 
one deeper in the stack (toward higher memory). Typing a comma 
steps in the other direction. The command is terminated by typing 
a period. MS always displays two memory words, the lower memo- 
ry address being the low order half. The pseudo stack pointer is 
not changed. 
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"It went 'zip' when it moved, and 'bop' when it stopped, 
And 'whirr' when it stood still 
I never knew just what it was and I guess I never will?' 


Chorus to The Marvelous Toy 
Song by Tom Paxton. 


Anyone who has read this far in a book like this must be viewed as 
a serious assembly language programmer, at least in prospect. Fol- 
lowing this calling involves, sooner or later, finding out something 
about the assembly process itself. It is to this need that the present 
chapter is addressed. 
The assembler in appendix B was specifically created to support 
the language used in this book. Further, to make it useful to the 
greatest possible number of readers, it is written in the 8080 subset, 
and is completely input/output independent, so that it can be run on 
any 8080 or Z80 based system with sufficient memory. The assem- 
bler itself requires about 10Kof RAM, the exact amount depending 
on the length of the I/O drivers supplied by the user. It contains no 
self modifying procedures other than the filling in of character 
strings in message frames, and can therefore be put into ROM with a 
minimum of modification. 
It was created with the secondary function of providing an instruc- 
tion vehicle for those who might find it necessary to delve into the 
mechanics of the assembly process itself. It is, therefore, not intend- 
ed to be a software tour de force or an example of optimal assembler 
design, but rather the most easily understood program which could 
be written to serve the purpose. To this end only the simplest possible 
techniques have been used. Instruction and symbol tables are sepa- 
rate and accessed by simple table lookup techniques. The sorting of 


the symbol table is done by a simple bubble sort. Exotic technique 
has been completely excluded for the sake of clarity, even at the sac- 
rifice of efficiency. 
Another constraint on the assembler was that it should be written 
for the convenience of the working programmer, 
not that of the as- 
sembler writer. While it may save some coding labor and simplify 
the design of the assembler to prohibit 
the working programmer 
from using labels which coincide with the names of machine regis- 
ters, it is preposterous 
to place this burden on the eventual user for 
the simple convenience of the assembler writer. The assembler writer 
need only grapple with the problem once when the system is created. 
Hundreds or thousands of users must live with the senseless restric- 
tions afterwards. This outlook has therefore been firmly rejected. 
The text editor has been similarly designed. It is the simplest possi- 
ble line oriented editor which will do the job. No exotic data struc- 
tures have been employed. The information 
is pushed about by the 
editor in what some might call "brute force" fashion. This again re- 
sults in some loss of efficiency when the program 
becomes long. 
When adding a line, for example, at the beginning of a program 1000 
lines long there is a perceptible pause of a fraction of a second before 
the addition is acknowledged, particularly 
on a system running at 2 
Mhz. Such is the cost of simplicity. Both text editor and assembler 
have been subjected to extreme testing and contain no known devia- 
tions from the specification of this book. If any are discovered by 
readers, the writer would greatly appreciate knowing of them so that 
they may be corrected in later printings. 
In the discussion of this chapter, reference will be made to various 
symbols. To find the locations corresponding to these symbols look 
them up in the symbol table at the end of the assembly listing. 
Execution of the editor/assembler, 
known hereafter collectively as 
the assembler, 
beings at location MON, just below the Franken- 
stein quote on the first page of the assembly listing. As has been 
pointed out in previous chapters, forgetting to load the stack pointer 
is a common error, so we do it first. The space immediately below 
MON is used as the stack space. The four CALLs which follow ini- 
tialize the interfaces for the terminal device, paper tape reader, pa- 
per tape punch and listing device, all routines supplied by the user 
for his own configuration, 
as described in appendix B. The reference 
to FLAG which follows the calls determines whether the pointer to 


the source program work space, known as the source buffer, 
has 
been initialized. If it has not control goes to CLR2 which performs 
the task. The flag is then cleared so that this branch of the program 
is not taken again. This procedure is executed only once when the 
program is loaded cold. The CALL at location MONt is for the ini- 
tialization of a general I/O device, a stub for future expansion to 
disk. The stack pointer load at MON2 seems redundant, but is re- 
quired by the return to this point from certain procedures which 
leave the stack pointer disturbed. 
The main monitor loop of the assembler is then entered, with the 
terminal carriage beinglfeturned and the prompt character (> ) being 
typed. The program then waits for keyboard input (RKB). The char- 
acter typed is then compared to the commands in the legal command 
list, i.e., /, L, D, A, R, P, and #. 
The / command, used when the buffer is to be cleared in prepara- 
tion for work on a new program, reinitializes the source buffer 
pointer and location NXTCHR to the first available buffer location. 
NXTCHR is used during the editing process to indicate the next 
available source buffer word. As noted before, the initialization flag 
is also cleared. 
The L command is a bit more complicated. It uses the same pro- 
gram machinery as the P (punch) command. This intertwining of 
code dates from the origin of the assembler when only a Teletype was 
available as both listing and punch device. The list function begins at 
location LIST with the clearing of a flag which differentiates be- 
tween the list and punch functions. The CALL FPRM fetches a pair 
of line numbers from the terminal keyboard, tests them for legality, 
i.e., do these lines exist and is the second line number greater than 
the first, and returns the memory addresses of the beinning character 
of each of the lines. The address of the beginning character of fhe 
line is found by counting the carriage returns which terminate each 
line in memory. The addresses of the first and last characters of the 
lines are left at BADRt, EADRt, BADR2 and EADR2 respectively. 
FPRM in turn calls PFCH (parameter fetch) to get the individual 
line numbers from the keyboard. It is at the PFCH level that the de- 
tection of the F symbol (for final line) is done. The line number is 
then converted and printed, followed by the text of the line which be- 
gins at BADRt. When a carriage return is encountered the process is 
repeated for the next line, this continuing under control of a count 


(IDIFF) which is the inclusive difference of the two line numbers 
named in the keyboard request. Note that the inclusive difference is 
used. This is because a request like 


implies the printing of six lines, not five. When the line count is ex- 
hausted control returns to MONl. 


The D command gets its limit parameters from the keyboard using 
FPRM. The inclusive difference IDIFF is again used to determine 
the number of lines to be deleted. The difference between the current 
line count LNCNT and IDIFF forms the new line count. The first 
character of the first nondeleted line above the deleted portion is 
then moved into the space occupied by the deleted material. Using 
the difference between this first nondeleted 
character 
address 
(EADR2+l) and NXTCHR the entire upper buffer is then moved 
down by the number of words indicated by EADR2-BADRl. 
The A function is by far the most complicated in the editor. A sin- 
gle line number is fetched by PFCH, the address of the beginning 
and end being determined by FBA (find buffer address). The charac- 
ter position one beyond the end of the named line will be the first 
word of the line to be added. This is the reason for the INX 
D just 
above ADDO. The carriage is then returned, a pointer to a buffer 
area at KB set into HL and the system waits for the typed input line. 
When the carriage return is encountered, the length of the typed line 
is determined and the entire source buffer above the point of inser- 
tion moved up by the amount required to accommodate the new line, 
if the existing buffer space will allow it. If insufficient space exists a 
buffer full message is delivered and the command is aborted. When 
the move has been completed, the new line is copied into the space 
thus created. NXTCHR is increased by the length of the line added 
and LNCNT is incremented. 


The R command reads text from the system paper tape device and 
appends it to the end of whatever is already in the source buffer. 
With each line read, NXTCHR and LNCNT are updated. 
The P command follows the same general track as L. The differ- 
ences are that pauses are executed at the beginning and end of 
punching, waiting for the space bar to be pressed. This is to allow 
for the situation in which a Teletype or similar device has the com- 


mon function of punch and listing device. The pauses (CALL 
SB) 
can be deleted if desired, along with the printing of the READY 
PUNCH, SPACE message. 
The # command sends control to the assembler proper, location 
ASM. At this point we must pause in the description of the mechan- 
ics to describe some logical characteristics of assemblers. What must 
be understood about this process from the outset is that the assembly 
program sees the user source program one line at a a time. A single 
line is read into an internal assembler buffer from the source pro- 
gram buffer or from paper tape. This line is then processed as a sin- 
gle entity. This structure, viewing the program a single line at a time, 
requires that the assembler process the source program twice. The 
first pass has as its principal function the formation of the symbol 
table, the list of all symbols which have been used as labels in in- 
structions or pseudo-ops and their values. The second assembler pass 
produces the actual object program using the symbol table to fill in 
the values required by the operands of the source statements. 
The reading of the source record into the assembler's internal buf- 
fer is not a simple transcription of the information from one place to 
another. Since the assembler allows freeform input, one space indi- 
cating an entire blank field, the record must be reformatted internal- 
ly to be processed. Note that even when the source text is only being 
listed, not assembled, it appears in rectified form, with all compo- 
nent fields in their proper places, however the source was originally 
typed in. This transformation is done by the FORMAT routine. The 
first character of the source record is examined for blank. If it is not 
blank the first six are copied into the internal buffer at LABEL, or 
characters are copied until a blank is encountered. If more than six 
characters appear in this label the remainder are ignored. The scan- 
ning then continues until more nonblank material is reached. This is 
copied into the instruction field of the internal buffer at MNEM. At 
this point a decision must be made about the remainder of the non- 
blank information in the line. If the instruction is of the LDA, LXI, 
SDY etc. variety it will require an operand. In this case the next non- 
blank information must go to the operand field at OPNDF. If the in- 
struction is of the RAL, NOP or EI variety the remaining nonblank 
material must be transcribed into the comment field at CFLD. To 
determine which situation is being dealt with the instruction is 
looked up in the main instruction table at ITBL. This table lookup is 


performed by the subroutine at OPSRC. Execution of OPSRC yields 
two results, the binary skeleton of the instruction and an instruction 
class word. The binary skeleton will not concern us yet. The instruc- 
tion class word contains the class, indicating the type of assembly 
processing required for this instruction, 
in the lower bits. The high 
bit of this word is a formatting flag. If this flag is a zero the instruc- 
tion requires an operand. If the flag is a one there is no required op- 
erand and the remaining nonblank text of the source line is copied 
into the comment field of the internal buffer. If an operand is re- 
quired, the nonblank text is copied into the operand field at OPNDF 
until a blank is encountered, 
any nonblank material after this be- 
coming commentary. 
This holds true under all conditions but one, 
namely that in which an apostrophe 
has been encountered 
in the 
transmitted 
string. This indicates the presence of an ASCII operand 
which may contain blanks. In this case the transmission 
continues 
until the first blank following the second apostrophe. 
In all cases of 
operand field transmission, if the operand length exceeds the allotted 
space (9 characters) the beginning of the comment field is moved to 
the right to make space for it. This will occur with expressions like 
LXI 
H,LONG-LONGER 
With all parts of the source statement in their proper fields in the 
internal buffer, the analysis of the line can proceed. Vital to this pro- 
cess is the FANLYZ (field analyze) routine. It scans a string of char- 
acters whose beginning address is given in DE, determines the field 
type (ASCII, decimal, hexadecimal, octai or symbolic) and returns 
the value of the field or sum or difference of fields to the calling pro- 
gram. Symbolic operands are looked up in the symbol table for their 
values. 
Under control of the assembly monitor beginning at ASM, PASSl 
of the assembler is executed. The symbol table count NSYMS is 
cleared as well as locations ILC, ORGVAL, TLFLAG and P2LNO. 
These last two can be skipped over for now, as they perform relative- 
ly minor functions. ILC is the instruction location counter, around 
which the activities of PASSl revolve. ILC is used as a pointer to the 
address of the next word to be assembled. When a label is encoun- 
tered in a source instruction it is the value of ILC which becomes the 
value of the label in most cases. ORGVAL is the value of the oper- 
and field of whatever ORG pseudo-op is in force currently. This will 
become clearer a little later. 


The processing 
proper 
begins at PIB with the fetching 
of a source 
record 
(FSRCD). 
Though 
no listing is done in the first pass the line 
number 
must 
be converted 
to decimal 
in case 
an error 
must 
be 
flagged 
(CNVLNO). 
Note that 
the high digit at the line number 
is 
converted 
but discarded. 
This is done to allow a wider comment 
field 
in the assembly 
listing. 
The label is examined 
for blank 
or asterisk, 
blank 
meaning 
no label, and asterisk 
in the first column 
meaning 
a 
comment 
line. Comments 
are ignored 
in pass 1. Next a check is made 
to see if the mnemonic 
field contains 
an EQU, 
the EQU 
requiring 
special 
processing 
during 
pass 
1. If it is an EQU 
the label is first 
checked 
for validity 
(CALL 
SLLBL), 
and the operand 
field is ana- 
lyzed. The operand 
field of an EQU must have already 
been defined 
when the EQU appears. 
This error 
must be detected 
and flagged 
in 
pass 1. If the operand 
field consists totally 
of defined 
elements, 
then 
the label of the EQU is entered 
into the symbol table with the oper- 
and value as the symbol value. 


Given that the mnemonic 
field does not contain 
EQU, the value of 
the label for this line becomes 
the current 
value of the ILC, if the la- 
bel is a legal one. A check is made to see whether 
this is the first ap- 
pearance 
of this label. 
If it is not, the symbol 
is multiply 
defined. 
This is noted 
in the symbol table by ANDing 
off the high bit of the 
first character 
of the symbol. 
This has no effect on the way in which 
this character 
is printed, 
since ASCII 
is indifferent 
to the value of 
the high bit. It serves as a flag for printing 
the M (multiply 
defined) 
error message in pass 2. 


The instruction 
class is then used to look up the length of this in- 
struction 
in the table beginning 
at PlLTBL. 
In a few cases in which 
the instruction 
length 
is ambiguous 
from 
the mnemonic 
a further 
check is made 
(CALL 
CKZ80) 
and the instruction 
class adjusted. 
The instruction 
length is then added to ILC to form its new value. If 
the instruction 
itself was undefined, 
Le., not a legal Z80 instruction 
the length 
defaults 
to 4, the maximum 
length 
of a Z80 instruction. 
With ILC incremented 
by the length of the instruction 
the process is 
repeated 
until an END is encountered. 


Some mnemonics 
require 
special action during pass 1. ORG resets 
ILC to the value of its operand 
field. 
RES, 
BSS, DATA and ASC 
may be of variable 
length. 
In these 
cases the field length 
is deter- 
mined and added to ILC as the length of the "instruction". 


When the END is encountered control returns to the assembly 
monitor. If the assembly involves listing (#L.) the symbol table is 
sorted (CALL SRTST) and various counters and flags are initialized 
for pass 2. A fresh page is then spaced up on the listing device 
(CALL EJECT) and the page number is printed (CALL PGN8). 
CALL PASS 2 is then executed. 
The actual production of the object code takes place in pass 2, us- 
ing the symbol table produced by pass 1. The processing of each 
source record begins with the clearing of error flags and conversion 
of the line number. This conversion takes place even on nonprinting 
assemblies because the line number will be required in the event of an 
error print out. Remember, lines containing errors are printed out in 
all assembly modes. The label is checked for legality and multiplicity 
of definition, these error flags being set if necessary. The instruction 
class is then used to compute the location of an address in the pointer 
table at P2JTBL. This address is then picked up from the table and 
transferred to the PC, sending control to the appropriate instruction 
processor. 
Each processor performs the necessary analysis to process the par- 
ticular instruction or pseudo-op class it services. The binary skeleton 
of each instruction is used, with operand modifiers where appropri- 
ate, to form the final object instruction. This involves 25 separate 
processing classes, making the pass 2 processor easily the most com- 
plex part of the assembler. Each of these separate processors takes 
the appropriate action and sets error flags where necessary. Each de- 
termines the correct length for the instruction being processed and 
adds it to ILC, just as was done in pass 1. An example of the type of 
error detection done can be seen just below location P2C2 (pass 2, 
instruction class 2). The CPI @66 checks against the forbidden con- 
figuration MOV M,M. If this were allowed to slip through the result 
in the object program would be :76, not a MOV at all, but one of 
those deadly halts from which no recovery can be made if the inter- 
rupts are disabled. 


Instruction classes B or greater are reserved for 2:80 only instruc- 
tions. Each of the processors for classes B or greater finishes its 
work by transferring control to location FLGZ80, whose purpose it 
is to place the dollar ($) in the listing to the left of the label fields of 
Z80 only instructions. Nonexistent instructions are fed to P2BDOP 


which defaults 
to an instruction 
length of 4 and produces 
4 words of 
zero in the object program. 


All 
instruction 
processors 
eventually 
lead 
to 
location 
P2ClB, 
which 
calls PCHOBJ 
(punch 
object). 
PCHOBJ 
does not actually 
punch 
the object 
code but merely 
collects 
it in a 128 word buffer, 
either 
until the buffer 
is full, or an ORG, 
RES or BSS is encount- 
ered. 
When 
one 
of 
these 
conditions 
arises 
the 
object 
buffer 
is 
punched 
out 
and 
a 
new 
record 
started. 
Control 
then 
goes 
to 
P2PRNT, 
the print supervisor. 
P2PRNT 
converts 
ILC 
for listing, 
the line number 
having 
been 
previously 
converted. 
The object 
code, 
up to four 
words, 
is then 
converted 
and placed in the listing buffer 
which begins at HEX. 
This 
is all done whether 
or not a listing is to be produced, 
since the infor- 
mation 
will be required 
if the line must be printed 
because 
of an er- 
ror. The error 
flag word ERRORS 
is then examined 
and the appro- 
priate 
ASCII 
error indicators 
set in the block beginning 
at ERLNE. 


If there are errors, 
the line is printed 
on the terminal 
device uncondi- 
tionally. 
There is no way to suppress 
this printing. 
If there are no er- 
rors and the pass does not involve 
listing 
(#E. or #0.) 
the location 
counter 
ILC is updated 
from 
the length 
of the instruction 
and the 
process 
repeated 
until the END is encountered. 
In the case of a #Z. 
assembly, 
the scan for Z80 only instructions, 
the instruction 
is print- 
ed unconditionally 
if it is of class B or greater. 
The detection 
of this 
condition 
is done in the FLGZ80 
routine. 
Following 
the detection 
of the END source line control 
returns 
to 
the assembly 
monitor 
which prints 
the previously 
sorted 
symbol 
ta- 
ble and restores 
paper if listing was in force. 
The object program 
is punched 
onto paper tape in discrete records 
which are of two types. 
The first, type 0, consists 
of data generated 
by instruction 
and 
data 
generating 
pseudo-ops 
like DATA, 
ASC, 
DBL, etc. The records 
consists 
of a record 
mark 
(:FF) a record 
ori- 
gin, a one frame 
record 
length, 
and the data record 
itself, 
followed 
by a simple 
additive 
checksum. 
Type 0 records 
are accumulated 
in 
the buffer 
beginning 
at RCDBLK, 
being punched 
out as described 
above 
when the next entry would 
overflow 
the 128 word buffer, 
or 
on command 
from DPOBJR 
(dump 
object 
record). 
The occurrence 
of an ORG, RES or BSS also forces the object buffer 
to be punched. 


With ORG this is because 
the presence 
of the ORG implies that an- 
other record 
with a different 
origin, 
possibly 
quite distant 
in memo- 


ry, will follow. With RES and BSS this is done to "close" 
the data 
record so that another record type, type 1, can be punched. RES and 
BSS have their own special record type because to attempt to punch 
them as type 0 records would lead to unacceptably long object tapes. 
Consider the implications of the source statement: RES 20000. Each 
of the 20,000 frames would have to be separately punched in a type 
zero record, divided into 128word blocks. 
A type 1 records consists of record mark :FF, the record origin, 
i.e., the value of ILC at the time the RES or BSS was encountered, a 
frame containing the record type, a "fill" 
flag, Le., a flag set to indi- 
cate the presence of the second operand with which the reserved 
space is to be filled, the fill value itself, and a checksum. 
The loader in ZEDBUG reads these records and loads them into 
the indicated places in memory. During the loading of type 1 records 
the system paper tape reader is stopped. This is done because a fill of 
excessive length could cause the reader to miss a character while the 
indicated 
fill value was being copied into the required 
memory 
space. On systems using only a Teletype as the tape read device there 
will be no damage done by the absence of reader control here, since 
the device is slow enough that no tape frame will be missed, even 
with large blocks. 
Note that ZED BUG is also capable of producing records in object 
format. The tapes produced by the ZED BUG D command, however, 
contain records which are exclusively of type O. These records may 
be 256 words in length, as contrasted with 128 for the object output 
of the assembler. Both types of tapes are loadable with the ZED BUG 
Lcommand. 
What follows this chapter are 4 appendices containing cold start 
instructions, the source text of the assembler and the instructions ror 
initializing it to particular 
I/O 
configurations, 
the source of the 
ZEDBUG debugging monitor with similar initialization instructions, 
and a cross index to allow translation between the Zilog mnemonics 
and those used in this book. 


APPENDIX A / 
LOADING 
PROCEDURES 
FOR OBJECT TAPES 


Paper 
tape object 
programs 
for both the assembler 
and the ZED- 
BUG monitor 
are sent at no charge 
to the original 
purchaser 
of this 
book 
when the coupon 
at the back 
of this book 
is returned. 
This 
appendix 
details 
the procedures 
necessary 
for loading 
these object 
programs. 
The object 
tapes 
supplied 
are in a special 
format 
which contains 
only type 0 records. 
These tapes are loaded 
by means 
of the special 
loader 
given below. 
The general 
procedure 
is to load the ZED BUG 
object tape first, initialize 
ZED BUG input/output 
routines, 
then use 
the ZED BUG dump 
facility to dump the initialized 
version 
of itself. 


The ZED BUG loader may then be used to load the assembler. 
When 
the assembler 
has been loaded 
it is initialized 
and the initialized 
ver- 
sion is then dumped 
via the ZEDBUG 
dump facility. 
To load the supplied 
object 
tapes, 
the following 
program 
must be 
placed into memory. 
This may be done using an existing ROM moni- 
tor, a front panel key in procedure 
or whatever 
means is at your dis- 
posal. The program 
is: 


location 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 


contents 
31 
80 
00 
C7 
FF 
FE 
FF 
20 
FB 
57 


8A 
8B 
8C 
8D 
8E 
8F 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 
9A 
9B 
9C 
9D 
9E 
9F 


FF 
6F 
FF 
67 
FF 
B7 
20 
OC 
FF 
47 
FF 
77 
23 
10 
FB 
5A 
FF 
AB 
28 
E6 
18 
FE 


This loader 
uses TRP (trap 
or restart) 
instructions 
as one word 
CALLs 
to shorten 
the amount 
which must be entered. 
In addition 
to 
the loader 
shown above, 
the user must supply two subroutines. 
The 
first, 
beginning 
at location 
0 and called by the TRP 
0 at location 
:83, must do whatever 
is necessary 
to initialize 
the paper tape reader 
interface 
and start the reader 
in your system. 
When control 
returns 
to location 
:84 of the loader 
program 
steps must have already 
been 
taken to move tape through 
the reader. 
If the reader is as simple as a 
Teletype without 
reader 
control 
this routine 
may consist 
only of the 
single word :C9 (RET) at location 
O. However 
long or short this rou- 
tine is, it must end with :C9. There are 5610 words available 
for this 
function, 
from 0 through 
:37. This routine 
must not disturb 
the stack 
pointer, 
but any other registers 
may be used. 
The 
second 
routine 
begins 
at 
:38 and 
is called 
by the 
various 
TRP 
7 instructions 
in the loader. 
Its function 
is to read one frame 


from the tape. It may use only the A register, disturbing nothing 
else, and it must end with the following sequence of words: 


PUSH 
PSW 
ADD 
D 
MOV 
D,A 
POP 
PSW 
RET 


None of the above is location dependent. It will be the same however 
long the read sequence for your system is. Your read sequence must 
end with these 5 words. They are the checksum computation 
for the 
loader and the load will be aborted after the first record of the tape if 
the checksum is incorrectly computed. 
As a guide to this initial key in process, the bootstrap 
loader 
preceded by the reader start and tape read routines for the writer's 
system is shown in assembled form immediately 
following these 
instructions. 
After all of this is in the lower memory locations indicated, set the 
PC to :80. Take the ZED BUG object tape and put it in the reader. 
Place the tape so that the read pins or photodiodes are on the blank 
leader. The first punched frame of the tape should be a rubout (all 
holes punched). If it is not you have the tape backwards in the read- 
er. When this is done start the computer running. If any operator ac- 
tion is required to physically start the reader, e.g., moving the Tele- 
type reader switch to START, do it now. If you have done everything 
up to this point correctly the tape will slew (run) through the reader. 
This loader will not stop the reader at the end of the tape. The tape 
will slew all the way through the reader until it runs out. At this 
point stop the computer and examine the PC. If the PC reads 9E or 
more the load was not valid. If the load procedure was correct the 


PC should contain a value somewhere in your tape read routine. If 
you get a bad load start the procedure over. The problem of tape er- 
ror has been eliminated beforehand. 
Every object tape has been 
loaded and verified before being sent. 


When you have loaded ZEDBUG successfully, follow the instruc- 
tions for initializing it in appendix C. After ZED BUG is up and run- 
ning, you can use the ZED BUG dump facility to generate a paper 
tape copy of itself with all of the proper input! output routines. To 
do this start ZEDBUG, and after the prompt character has appeared 
(#), type: 


where NNNN is the last address used by your ZEDBUG I/O rou- 
tines. The computer will pause to allow 'you to turn on the punch. 
When you have turned the punch on tap the space bar. Your custom- 
ized version of ZED BUG will be punched preceded and followed by 
a few inches of blank tape. The computer will again pause to allow 
you to turn the punch off. These pauses are for systems equipped 
with only a Teletype. Tap the space bar and control will return to the 
ZEDBUG monitor. 
You may now use your customized version of ZED BUG to initial- 
ize the assembler. There is no more need for the special loader in 
lower memory. Simply put the assembler tape in the reader and type: 


in response to the ZED BUG prompt character (#). Start the reader if 
necessary (reader switch to START position on Teletype) and the 
tape will be loaded. If the load is successful it will end with the 
prompt character. If it is not the word: 


will be typed, meaning checksum error. Again, tape error has been 
eliminated by the verification of each tape before it is sent. The trou- 
ble may be dirt in the reader or something caught in the holes of the 
tape. This last can easily occur if the tape is allowed to drag along 
the floor while being loaded or rewound. 


Next go to appendix B, and follow the instructions there for ini- 
tializing the assembler for your I/O configuration. When you have 
done this use the ZEDBUG dump facility again to get a tape copy of 
the assembler customized to your I/O configuration. This is done by 
typing: 


where XXXX is the highest memory location used by your I/O rou- 
tines. The computer will pause before and after punching as before, 
waiting for the space bar to be tapped. 
If your system is equipped with disk, both ZEDBUG and the as- 
sembler can now be copied to disk. Whether or not you have a disk, 
you should punch the customized paper tape copies. If a disk crash 
occurs it will save all of the labor of reinitializing. It goes without 
saying, of course, that a backup copy should be kept of any disk 
which contains important software or data. 


BOOTSTRRP 
LORDER 


.'#< 
THIS 
ROUTINE 
INITIRLIZES 
RND 
STRRTS 


.'#< 
THE 
PRPER 
TAPE 
READER 
IN 
THE NRITER'S 


.'#< S~'STEM..R REMEX 
READER 
CONTROLLED 
B~' 
* R MOTOROLA 
6820. 


ORG 
0 


l102 
883 
004 
885 
006 
887 
l1l18 
809 
OW 
011 
012 
013 
l1/4 
015 
0/6 
0/7 
0/8 
019 
020 
021 
ll22 
823 
024 
025 
026 
t7t27 
t128 
829 
l130 
031 
t132 
033 
034 
0038 
DB/2 
035 
(103R /7 
036 
0038 
30FB 
037 
003D 
DB/3 
038 
039 
0411 
041 
042 
043 
044 
003F 
F5 
045 
0040 
82 
046 
0041 
5;:' 


04;:'8042 
FI 
048 
l1043 C9 
049 
050 
051 
052 
053 
l154 
055 
056 
05? 
058 
859 
0080 
31 ~'1000 


0000 
RF 
SRDR 
ZAR 
000/ 
D3/O 
OUT 
CTLA 
0003 
D312 
OUT 
CTLB 
8005 
0313 
OUT 
DTAB 
000;:'3D 
DCR 
A 
0008 
03/1 
OUT 
DTAA 
OOllA 3E04 
pfl/I 
A ..4 
OOOC 
D3/0 
OUT 
CTLA 
l100E 3El16 
nv I 
A ..6 
0010 
D3/2 
OUT 
CTLB 


l1012 3EllF 
nllI 
A ..'F 
0014 
D31/ 
OUT 
DTAA 
00/6 
C9 
RET 
CTLA 
EQU 
'10 
DTRA 
EQU 
CTLA+-I 
CTLB 
mu 
DTAA+-/ 
DTAB 
EQU 
CTLB+-/ 
* THIS 
ROUTINE 
READS 
ONE 
TAPE 
FRAME 


.'#< FRon 
THE 
REMEX 
READER 
RND 
RETUf...'NS 
* IT IN A. 
NOTE 
THAT 
ONLY 
THE 
A REG. 


.'#< 
IS USED ..EXCEPT 
AS 
SHONN 
TO COMPUTE 


.'#< 
THE 
CHECKSUM. 


ORG 
'38 
IN 
CTLB 
RRL 
BNC 
PCHR 
IN 
DTAB 


THIS 
ROUTINE 
MUST 
END 
NITH 
THESE 
.5 INSTRUCTIONS 
NHICH 
COMPUTE 
THE 
TAPE 
CHECKSUM 


SAVE 
FRAME 
FORM 
NEN 
CHECKSUM 
SA\lE UPDATED 
CHECKSUPt 
RETRIEVE 
FRRNE 
nUST 
END 
NITH 
RETURN 


.'#< NITH 
THE EXCEPTION 
OF 
THE 
CHECKSUN 


.'#< SEfWENCE 
RBOVE .. THE 
RBOVE 
ROUTINES 


.'#< NILL 
BE 
DIFFERENT 
FOR 
~'OUR S~'STEN. 


.'#< 
THE 
FOLLOIHNG 
taLL 
BE 
COMMON 
TO ALL 


.'#< SYSTEMS. 
IT USES 
THE 
TNO SPECIAL 
* USER 
St~PLIED 
ROUTINES 
AT 
0 RND 
'38 
* THIS 
IS 
THE 
BOOTSTRAP 
LOADER 
PROPER. 


PUSH 
PSN 
ADD 
D 
MOV 
D ..A 
POP 
PSI4 
RET 


860 
8l'lS3 
C7 
861 
00S4 
FF 
t162 l'lOS5 FEFF 
863 
88S7 
2oF8 
864 
8tlS9 57 
865 
aOSR 
FF 
1366 eOS8 
6F 
067 
80SC 
FF 
t16S l'lOSD 67 
869 
80SE 
FF 
t170 tl0SF 87 
871 
8098 
200C 
fJ72 
tl092 
FF 
873 
0893 
47 
t174 tlt194 
FF 
075 
8t195 n 
076 
0096 
23 
8n 
8l'l97 
18F8 
07S 
Ot199 5R 
879 
8t19R FF 
13S0 0098 
R8 
881 
a89C 
28E6 
OS2 
Ol'l9E ISFE 
083 
OoRo 


TRP 
TRP 
CPI 
8NE 
!'tOV 
TRP 
!'tOV 
TRP 
!'tOV 
TRP 
ORR 
8NZ 
TRP 
!'to V 
TRP 
!'to V 
INN 
D8NZ 
!'tOV 
TRP 
KRA 
8Z 
BRA 
END 


*************************** 
*S~'!'tBOL 
TABLE* 
*************************** 


CTLA 
ERROR 
PCHR 


Ot'l/O 
tl09E 
003S 


CTL8 
LI 
SLOAD 


0812 
00S4 
00S8 


DTRA 
L2 
SRDR 


!'t ..R 
H 
L3 
£..0 


E 
LI 
ERROR 


001/ 
tl0S9 
0800 


START 
READER 
GET 
TRPE 
FRRNE 
CHECK 
FOR 
RECORD 
!'tARK 
LOOP 
BACK 
IF NOT 
START 
CHECKSUN 
GET 
TRPE 
FRANE 
LOW 
ORIGIN 
GET 
TRPE 
FRANE 
HIGH 
ORIGIN 
GET 
TAPE 
FRANE 
CHECK 
RECORD 
T~~E 
BRD 
IF NOT 
ZERO 
GET 
TAPE 
FRA!'tE 
SET 
RECORD 
LENGTH 
GET TAPE 
FRANE 
LOAD 
DATA 
RECORD 
BUNP 
POINTER 
LOOP 
TILL 
FINISHED 
SAVE 
CHECKSUN 
GET 
TAPE 
CHECKSUM 
CO!'tPARE CHECKSUNS 
OK 
IF ZERO 
OTHERWISE 
ERROR 


APPENDIX B I 
THE ASSEMBLY 
PROGRAM 


The Z80 resident assembler will function with a wide variety of in- 
put/ output configurations, from a simple Teletype to high speed pa- 
per tape equipment, line printers, CRTs, etc. To use any specific con- 
figuration, the assembler must be provided with the input/output 
routines required by the particular devices. There are 15 possible 
routines to be initialized. These routines begin at the end of the as- 
sembler, location :2465. A jump to each routine is placed in the as- 
sembler I/O jump table which begins at :15C(see second page of as- 
sembler listing, this appendix). The routines are: 


INTRML 
Initialize terminal interface. This routine does whatever 
is necessary to initialize the device you are using for a 
terminal. All registers may be used. 


RDRINT 
Initialize reader interface. This routine performs any 
initialization required by the paper tape reader inter- 
face. All registers may be used. 


PDVINT 
Initialize punch interface. This routine initializes the 
paper tape punch interface where necessary. All regis- 
ters may be used. 


LDVCIN 
Initialize 
printing 
device 
interface. 
This 
routine 
initializes the interface for whatever device is being used 
for listing. This is the device on which assembly listings 
willbe produced. All registers may be used. 
. 


Note before going further that if only a Teletype is used the func- 
tions of all of the above routines may be accomplished by the 
INTRML routine. 


DTCTCC 
Detects Control-C 
typed on terminal. 
This routine 
should return with the carry bit on if Control-C was 
typed, off otherwise. It should not wait in a loop for 
something to be typed, merely detect whether some- 
thing has already been typed. If nothing has been typed 
return with carry off. If something other than Con- 
trol-C was typed return with carry off. Only the A regis- 
ter may be used. 


RDRSTT 
Start the paper tape reader. Only the A register may be 
used. 


RDRSTP 
Stop the paper tape reader. Only the A register may be 
used. 


GTPCHR 
Read a character from the paper tape reader. Use only 
the A register. The character is returned in the A register, 
forced to upper case ASCII with the high bit forced to 
one. The high bit can be forced to one by 
ORI 
:80. 


SB 
Wait for space bar to be struck. Do not return until it 
has been struck and ignore all other characters. Do not 
echo the character back to the terminal. Use only A. 


CPNT 
Send the character in A to the system listing device. 
Send the character first, then test for device ready. All 
registers including A must return unchanged. 


PCHCHR 
Punch the character in A on the system punch device. 
All registers must return unchanged. 


RKB 
Read a character from the terminal keyboard. Do not 
return until something has been typed. The character re- 
turned must be in upper case ASCII with the high bit 
forced to one (ORI 
:80). Return the character read in 
A. No other registers may be used. To force upper case 
ASCII check whether the characters is in the :El-:FA 
range after the high bit has been set to one. If it is in this 
range execute ANI 
:DF (E6 
DF). 


OUT 
Send the character 
in A to the terminal 
device. 
All 
registers including A must return unchanged. 


REWIND 
This is an optional 
routine provided 
for those who wish 
to modify the assembler 
for nonstandard 
devices. It is 
called by the assembler before each pass. 


ODVCIN 
Initialize 
general device. Also provided 
for those who 
may wish to modify the assembler 
for nonstandard 
de- 
vices. It is called before the first assembler pass. 


All of these routines 
are to be written 
as subroutines, 
Le., they 
must end with an RET instruction. 
Routines which are not required 
may consist of nothing but the RET. 
When the above routines have been created they are to be entered 
into memory 
beginning 
at :2465. The jump 
table at :15C must be 
filled in with a jump instruction 
to the routine 
named in that posi- 
tion. A JMP is a C3. If INTRML 
began at :2465, the first entry in 
the jump table would be: 


location 
15C 
15D 
15E 


contents 
C3 
65 
24 


The jump table is then filled in, beginning at :15C, in the following 
order: 


JMP 
INTRML 
JMP 
RDRINT 
JMP 
PDVINT 
JMP 
LDVCIN 
JMP 
DTCTCC 
JMP 
RDRSTT 
JMP 
RDRSTP 
JMP 
GTPCHR 
JMP 
SB 
JMP 
CPNT 
JMP 
PCHCHR 


JMP 
RKB 
JMP 
OUT 
JMP 
REWIND 
JMP 
GDVCIN 


RET 
RES 
2 


which is C9, 00 and 00 in hexadecimal. Note that all three words are 
required. 
This is really a good deal simpler than it looks. In a system using 
only a Teletype requiring no initialization, and having no reader con- 
trol, the jump table looks like this: 


BC 
RET 
terminal initialize 
RES 
2 
15F 
RET 
reader initialize 
RES 
2 
162 
RET 
punch initialize 
RES 
2 
165 
RET 
printer initialize 
RES 
2 
168 
JMP 
DTCTCC 
detect Control-C 
16B 
RET 
reader start 
RES 
2 
16E 
RET 
reader stop 
RES 
2 
171 
JMP 
GTPCHR 
get paper tape frame 
174 
JMP 
SB 
wait for space bar 
177 
JMP 
OUT 
print character on 
listing device 
17A 
JMP 
OUT 
punch character 
lID 
JMP 
RKB 
read from keyboard 
and echo 
180 
JMP 
OUT 
print character 
on terminal 


RET 
rewind exotic I/O 
device 
RES 
2 
RET 
initialize 
exotic I/O 
device 
RES 
2 


A system having a more elaborate 
set of peripherals 
can use them 
to advantage. 
The writer's 
system has a CRT, high speed paper 
tape 
reader 
and 
punch 
and 
a line 
printer. 
As a guide 
to the 
general 
scheme, 
the initialization 
of this system is in source form before 
the 
assembler 
command 
summary 
in this appendix. 
The final adjustment 
which must be made to the resident 
assem- 
bler is to define the memory 
space which can be used as source buff- 
er. The address 
of the beginning 
of the source buffer 
is loaded 
into 
location 
:247 and 
:248, the low order 
word 
in :247, high word 
in 


:248. The address 
of the last available 
buffer 
word is entered 
into lo- 
cations 
:249 and :24A. The beginning 
address 
of the buffer 
will nor- 
mally 
be the first 
location 
beyond 
the end of the assembler's 
in- 
put/output 
drivers. 
With the I/O 
drivers shown for the writer's 
sys- 
tem this location 
is :2536. The last available 
word may be the highest 
physical 
memory 
word. 
In the writer's 
system this is :9FFF (40K sys- 
tem), 
but to protect 
various 
utility 
programs 
(including 
ZED BUG) 
located 
at :9000 and beyond 
this address 
is set to :8FFF. 
The four 
words are thus: 


location 
247 
248 
249 
24A 


content 
36 
25 
FF 
8F 


in the writer's 
system. 
If ZEDBUG 
were to be protected 
in a 16K sys- 
tem the address 
in :249 and :24A would be :3600, the 00 in :249 and 
the :36 in :24A. 
When 
all of these initialization 
steps have been taken, 
set the PC 
of your computer 
to :100 and start it. It should 
respond 
with the as- 
sembler prompt 
character 
(». 
To test the assembler 
type in example 
4-1 as per the instructions 
in chapter 
5, and try a test assembly. 
If it is 


successful clear the assembler source buffer with a /. command and 
transfer control to ZEDBUG. An initialized paper tape copy of the 
assembler can now be punched by typing: 


where AAAA is the address of the last word of your input/output. 
Don't forget that the dump function of ZED BUG pauses before and 
after punching to allow you to turn the punch on and off. Tapping 
the space bar resumes activity. 
You now have a working assembler. If you have a disk this is the 
time to make a disk copy. 


The editor/assembler 
indicates its readiness to accept a command 
by typing the prompt character. All commands are terminated with a 
period. Use of the letter F in place of a line number indicates the last 
line of the source buffer. Any illegal command will draw"?" 
as a 
response, and the command will be ignored. 


Add text lines after line n in the existing text. If no 
line number is given, or if n is given as zero, the text 
typed in will be added before any existing text. Each 
line is terminated by a carriage return. The A com- 
mand itself is terminated by using a period as the first 
character of a text line. 


Ln. or Ln m. 
Lists line n or lines n through 
m on the system 
terminal device. Each listed line is preceded by a four 
digit line number and is formatted 
into appropriate 
fields. 


Pn. or Pn m. 
Causes line n or lines n through m to be punched on 
the system punch device. The execution of the P com- 
mand is preceded and followed by a pause to allow 
the punch device to be turned on and off. This is re- 
quired when the punch and terminal devices are the 
same physical peripheral, e.g., a Teletype. The text 
lines are punched with no superfluous blanks and the 
text is preceded and followed by several inches of 
blank tape. 


R. 
Reads text lines from the system paper tape read 
device and adds them to the end of what is already in 
the buffer. No reader start/stop control is necessary 
to use this command. 


#L. 
Assembles the program in the source buffer and 
prints the assembly listing on the system listing 
device. 


#0. 
Assembles the program in the source buffer and 
punches an object tape on the system punch device. 
The message READY PUNCH, SPACE will appear 
followed by a pause. Press the space bar to begin 
punching. 
When punching 
has 
finished 
another 
pause is executed. Press space to return to command 
mode. 


#E. 
Assembles the program in the source buffer printing 
only lines which contain errors on the system termin- 
al device. Errors uncovered by this error scan process 
can then be corrected by the D and A commands of 
the text editor. 


#Z. 
Assembles the program in the source buffer printing 
lines which contain Z80 only instructions and lines 
containing errors. This mode is provided as a conve- 
nient means of flagging Z80 only instructions in pro- 
grams which must retain 8080compatibility. 


P 
Symbol which appears in the operand field of an EQU, RES or 
ORG has not been defined previous to its appearance as an 
operand. 


S 
A symbol is used as a label which violates the rules for symbol 
formation. A symbol must begin with an alphabetic character, 
be from one to six characters in length and may not contain +, 
-orcomma. 


A 
A branch instruction (relative jump) attempts to address a point 
outside the branch range PC+127 to PC-128. 


M 
Multiple symbol definition. The same symbol has been used 
more than once as a label. Note that this will occur if two sym- 
bols exceed the six character length but have the same first six 
characters. The assembler ignores characters after the first six. 


L 
The length of the operand of this instruction exceeds the legal 
length for this instruction. 


U 
The operand of this instruction or pseudo-op is undefined or 
contains an undefined element. 


o 
The instruction field does not contain a legal 8080 or Z80 
mnemonic or a legal pseudo-op. 


D 
The displacement field of an indexed instruction contains an 
undefined element or generates data which cannot be held in 
eight bits. 


Programs too long to be held in available memory may be assem- 
bled directly from paper tape. Reader on/ off control is necessary to 


use this option. Assembly from tape is accomplished by typing T as 
the second character of the assemble command, i.e.: 


Mount the tape on the system paper tape reader and type the selected 
command. The tape will slew through the reader and stop. Remount 
the tape and press the space bar. The tape will again slew through the 
reader and the program will assemble as per the assembly specifica- 
tion, L, 0, E or Z. 
Tape programs may be segmented by making the last line of each 
tape segment except the final one begin with an exclamation point. 
This line will not enter into the assembly but will stop the reader and 
cause a pause to load the next tape segment. Pressing space will re- 
sume tape reading. The last tape segment terminates with the END 
statement and no exclamation point. 


Note that in assembling very long programs (like the assembler it- 
self) there will be a delay of some seconds between the two passes of 
the tape. This is because the symbol table is being sorted. Mount the 
tape for the second pass and tap the space bar. When the symbol ta- 
ble sort is finished the reader will start. 


802 
8E13 815C 
C36524 
884 
t1/5F C36E24 
805 
8162 
C38424 
006 
0 I65 C3D 724 
007 
8168 C39524 
t108 t'l/6BC3A724 
889 
816E 
C3AC24 
Olt'l 
t1/71 C3BI24 
all 
al74 
C3BC24 
t112 t1177 C3CC24 
013 
al7A 
C3a025 
al4 
817D 
C31C25 
815 
al80 
C32A25 
t1/6 t'l183C9 
017 
8184 
018 
8186 
C9 
819 
0187 
02t1 
1321 
t122 
823 
824 
2465 
3E83 
1325 2467 
0320 
t'l262469 
3E I I 
1327 246B 
0320 
t128 246D 
C9 
1329 
830 
1331 
t132 
1333 246E 
AF 
t'l34 
246F 
D31 t1 
1335 2471 
D312 
036 
2473 
D313 
1337 2475 
30 
838 
2476 
D31/ 
1339 2478 
3E134 
048 
247A 
D3/8 
134/ 247C 
3E136 
842 
247E 
D3/2 
1343 2488 
COAC24 
844 
2483 
C9 
045 
846 
047 
848 
1349 
858 
05/ 
2484 
AF 
052 2485 
D3/4 
053 
2487 
0316 
854 
2489 
3D 
855 
248A 
D317 
856 
248C 
3E84 
1357 248E 
0314 
858 
2498 
3E36 
059 
2492 
0316 


ORG 
'15C 
J1'1P 
INTR1'1L 
JNP 
RDRINT 
J/'IP 
PDI/INT 
J/'IP 
WI/CIN 
J1'1P 
DTCTCC 
J1'1P 
RDRSTT 
J/'IP 
I':ORSTP 
J~IP 
GTPCHR 
J1'1P 
SB 
J1'1P 
CPNT 
J1'1P 
PCHCHR 
J1'1P 
RKB 
J/'tP 
OUT 
RET 
RES 
2 
RET 
RES 
2 


ORG 
'2465 
* TER/'tINAL DEI/ICE 
INITIALIZATION 
INTR1'1L 
1'1'v'I A.o3 
OUT 
STAT 
/'II/I R.o'/1 
OUT 
STAT 
RET 
STAT 
EQU 
'28 
DRTR 
EQU 
STRT+I 
* TRPE 
READER 
INTERFACE 
INITIALIZE 
RDRINT 
ZAR 
OUT 
CTLA 
OUT 
CTLB 
OUT 
DTRB 
DCR 
A 
OUT 
DTRR 
/'tv I 
A,4 
OUT 
CTLR 
1'1'v'I A,6 
OUT 
CTLB 
CALL 
RORSTP 
RET 
CTLA 
EQU 
'113 
DTRA 
EQU 
CTLA+ / 
CTLB 
EQU 
DTAA+I 
DTAB 
EQU 
CTLB+ 1 
* PUNCH 
DEI/ICE 
INITIRLIZRTION 
PDI/INT 
ZAR 
OUT 
OUT 
DCR 
OUT 
/'tVI 
OUT 
1'1VI 
OUT 


CTR 
eTB 
A 
DTB 
R.o4 
eTA 
A, '36 
eTB 


ll68 2494 
C9 
861 
862 
863 
864 
865 
866 2495 
D828 
867 2497 
IF 
868 2498 D8 
869 2499 
D821 
ll78 2498 
F688 
1371 249D 
FE83 
1372 249F 
C2R424 
873 
24R2 
37 
874 
24R3 
C9 
875 
24R4 
87 
ll76 24R5 
C9 


-877 
24R6 
C9 
a18 
879 
888 
24R7 
3E8F 
881 
24A9 
D31 I 
1382 24R8 
C9 
883 
884 
885 
24RC 
3EF8 
1386 24RE 
D3 II 
887 2488 
C9 
888 
889 
a913 
1391 
1392 2481 
D812 
893 2483 
17 
ll94 2484 
D28124 
895 2487 
D813 
896 2489 
F688 
897 2488 C9 
a98 
899 
188 248C 
D828 
181 248E 
IF 
182 248F 
D28C24 
183 24C2 
D821 
184 24C4 
F688 
185 24C6 
FER8 
Ill624C8 
C28C24 
187 24CB 
C9 
188 
189 
118 24CC 
D31F 
III 24CE 
D81E 
112 24D8 
17 
I13 24D I D2CE24 
114 24D4 
D81F 
115 24D6 
C9 
1/6 
1/7 


RETURNS 
J4ITH CRRR~' ON 
IF 
CONTRoL-C 
J4RS H'PED ..OFF 
oTHERJ4I5E. 
DTCTCC 
IN 
STRT 
RRR 
RNC 
IN 
DRTR 
oRI 
:88 
CPI 
:83 
JNE 
DTC2 
5TC 
RET 
DTC2 
RSC 
RET 
RET 


.'/< STRRT 
PAPER 
TRPE 
RERDER 
RDRSTT 
NVI 
R.oGo8IT5 
OUT 
DTAA 
RET 


.'/< STOP 
PAPER 
RDRSTP 
NVI 
OUT 
RET 
G08ITS 
EQU 
STP8IT 
EQU 


TRPE 
READER 
A,5TP8IT 
DTRR 


:F 
:F8 


.'/< GET 
CHARRCTER 
FRON 
PAPER 
TAPE 
RERDER 
GTPCHR 
IN 
CTL8 
RAL 
JNC 
GTPCHR 
IN 
DTRB 
oRI 
:88 
RET 


.'/< J4RIT FOR 
SPRCE 
8RR 
58 
IN 
STRT 
RRR 
JNC 
58 
IN 
DRTR 
oRI 
:88 
CPI 
JNE 
58 
RET 


.'/< PRINT 
CHRRRCTER 
ON LISTING 
DEVICE 
CPNT 
OUT 
D8 
CP2 
IN 
C8 
RRL 
JNC 
CP2 
IN 
D8 
RET 


118 ND7 
RF 
119 24D8 
D31C 
120 24DR 
DJIE 
121 
24DC 
3D 
122 24DD 
DJIF 
123 24DF 
3Ef11 
124 24EI 
DJID 
125 24E3 
3Ef14 
126 24E5 
DJ/C 
127 24£7 RF 
128 24E8 
DJID 
129 24EA 
3Ef11 
13tl 24EC 
DJID 
131 24EE 
3E2C 
IJ2 NFt'! DJIE 
133 24F2 
D81F 
IJ4 
24F4 
JERtl 
135 24F6 
865& 
IJ6 24F8 
CDCC24 
137 24FB 
85 
/38 24FC C2F824 
139 24FF 
C9 
140 
141 
142 
143 
144 
145 
146 
2500 
DJI7 
147 
2582 
D815 
148 2504 
£681 
/49 2586 
C20225 
150 2509 
3EJE 
151 2588 
DJI6 
152 25tlD JEJ6 
153 
258F 
DJI6 
154 2511 
D817 
155 2513 
D816 
156 2515 
17 
157 
2516 
D21J25 
158 2519 
D81? 
159 
2518 
C9 
160 
161 
162 
163 
164 
165 
166 251C 
D820 
167 251E 
IF 
168 251F 
D21C25 
J69 2522 
D821 
I ?tl 2524 
F68t.l 
171 2526 
CD2R25 
/72 
2529 C9 
173 
174 
175 252R 
0321 


LDVCIN 
ZRR 
OUT 
CR 
OUT 
C8 
DCR 
R 
OUT 
08 
/'IVI 
R.ol 
OUT 
DR 
NVI 
A.o4 
OUT 
CR 
ZRR 
OUT 
DR 
NVI 
R,I 
OUT 
DR 
/'IVI 
R.o'2C 
OUT 
C8 
IN 
D8 
/'IVI 
R, , , 


NVI 
8.-80 
LDVC2 
CRLL 
CPNT 
OCR 
8 
JNZ 
LDVC2 
RET 
CR 
Et~U 
'IC 
DA 
ElW 
CA+I 
C8 
EQU 
DR+I 
D8 
£au 
C8+1 
* PUNCH 
CHRRRCTER 
ON 
PUNCH 
DEVICE 
PCHCHR 
OUT 
DT8 
PCH2 
IN 
DTR 
RNI 
'81 
JNZ 
PCH2 
/'IVI 
R.-'JE 
OUT 
CT8 
f1VI 
R, '36 
OUT 
CT8 
IN 
DT8 
PCHJ 
IN 
CT8 
RRL 
JNC 
PCHJ 
IN 
DTB 
RET 
CTR 
EQU 
'14 
DTR 
EQU 
CTR+I 
CT8 
EQU 
DTR+I 
DT8 
EQU 
CT8+1 
* RERD 
CHRRRCTER 
FRON 
TER/'IINRL DEVICE 
RK8 
IN 
STRT 
RRR 
JNC 
RK8 
IN 
DRTA 
ORI 
'80 
CRLL 
OUT 
RET 
* OUTPUT 
CHRRRCTER 
TO 
TER/'IINRL DEVICE 
OUT 
OUT 
DRTR 


345 


PAGE 
84 
I/O ASSIGNMENTS 
FOR 
Z80 
ASSEMBLER 


116 252C 
F5 
PUSH 
PSl4 
/77 
252D 
DB20 
OUT2 
IN 
STAT 
118 252F 
IF 
RAR 
/79 
2530 
IF 
RAR 
180 253/ 
D22D25 
JNC 
OUT2 
181 2534 
FI 
POP 
Ps~J 
/82 2535 
C9 
RET 
/83 2536 
88 
EOI/O 
"''''* 
184 
ORG 
:241 
185 0247 
3625 
DBL 
EOI/O 
INITIALIZE 
BUFFER 
186 0249 
END 


*************************** 
"'SYMBOL 
TABLE* 
*************************** 


CR 
OOIC 
CTA 
8014 
DR 
t1t11 D 
c>TAR 
80// 
DTCTCC 
2495 
INTRML 
2465 
OUT2 
252D 
PD .•.INT 
2484 
RKB 
251C 


CB 
t10lE 
CTB 
8016 
DRTR 
t1021 
DTAB 
80/3 
EOI/O 
2536 
LDVC2 
24F8 


PCH2 
2502 
RDRINT 
246E 
sB 
24BC 


CP2 
24CE 
CTLA 
0010 
DB 
t1t11F 
DTB 
80/7 
GOB ITS 
OOl~F 
LDVCIN 
2407 
PCH3 
2513 
RDRsTP 
24RC 
STAT 
0020 


CPNT 
CTLB 
DTR 
DTC2 
GTPCHR 
OUT 
PCHCHR 
RDRSTT 
5 TPBIT 


24CC 
88/2 
0015 
24R4 
24B/ 
252R 
2500 
24R? 
OOFO 


ASSEMBLY LISTING OF 
THE ASSEMBLY PROGRAM 


13t.~2 
aa3 
1.11.14 
1385 
13t.~6 
88? 
81.'18 
aa9 
131t.~ 
all 
012 
1313 
1314 
815 
1316 
01? 
8188 
3/881.'11 
818 
1.1183 CD5Ct.~ 
1 
819 
0106 
CD5FOI 
020 
0109 
CD6281 
821 818C CD6581 
022 810F 3R5982 
82381128? 
824 8113 C2F382 
8258116 
CD860 I 
026 8119 318881 
827 811C CD8981 
828 811F 3E8E 
829 812/ CD888 1 
838 8/24 CD?DOI 
03/ 8127 FERF 
832 8129 CREB02 
833 812C FECC 
834 812E CRl103 
835 8131 FEC4 
836 8133 CRF21.'13 
837 8136 FECI 
t.~388138 
CR3Bt14 
839 013B FED2 
848 813D CR3E05 
841 8148 FED8 
842 8142 CR8983 
843 8145 FER3 
844 8147 CR5EI8 
845 
846 
847 
1.1488/4R FE88 
849 814C CR8888 
858 814F FE8t.~ 
851 8151 CR8888 
852 8154 FE8t."! 
853 8156 CR8888 
854 8159 C3E882 
855 
856 
85? 
858 
859 


******************************************** 
* 
* 
* RESIDENT RSSEMBLER FOR Z88 BRSED SYSTEMS * 
* 
* 
* COP'r'RIGHT/oIRLTERJ. /oIELLER MR'r'1978 
* 
* 
* 
******************************************** 
** 
"I BEHELD 
THE /oIRETCH- THE MISERRBLE MONSTER 
* 
/oIHOMI HRD CREATED. " 
* 
FRANKENSTEIN 
* 
MRRY /oIOLLSTONECRRFTSHELLEY 
* 
.'/< 
ORG 
LXI 
CRLL 
CRLL 
CRLL 
CALL 
LDR 
ORR 
JNZ 
CRLL 
LXI 
CALL 
MVI 
CALL 
CRLL 
CPI 
JEQ 
CPI 
JEQ 
CPI 
JEQ 
CPI 
JEQ 
CPI 
JEQ 
CPI 
JEQ 
CPI 
JEQ 


:188 
SP,MON 
INTRML 
RDRINT 
PD~'INT 
LDVCIN 
FLRG 
A 
CLR2 
GDVCIN 
SP,MON 
CRLF 
R.t /)/ 
OUT 
RKB 
,/' 
CLERR 
'L' 
LIST 
'D' 
DELETE 
'A' 
RDD 
'R' 
RERD 
'P' 
PUNCH 
'It' 
RSM 


ENTRY 
INITIRLIZE 
TERMINRL INTERFRC 
INITIALIZE PTR INTERFRCE 
INITIRLIZE PUNCH INTERFRCE 
INITIALIZE LISTING DEVICE 


INITIRLIZED 
YET? 
NOT IF NON ZERO 


PRINT PROMPT CHARACTER 
GET COMMRND 


*********************************** 
* INPUT/OUTPUT 
CONTROL ROUTINES * 
********************************* 


CPI 
8 
JEQ 
8 
CPI 
8 
JEQ 
8 
CPI 
8 
JEQ 
8 
JMP 
ERR 


068 
86/ 
862 8/5C 
C9 
863 
0/5C> 
864 
865 
866 
8/5F 
C9 
867 
0/60 
868 
869 
078 
8/62 
C9 
87/ 
0/63 
072 
073 
074 
0/65 
C9 
075 
0/66 
876 
877 
878 
8/68 
C9 
079 
0/69 
088 
88/ 
082 
8/68 
C9 
883 0/6C 
884 
885 
086 8/6E 
C9 
887 8/6F 
888 
889 
098 
8/7/ 
C9 
89/ 
8/72 
892 
893 
094 
8/74 
C9 
895 
8/75 
896 
897 
898 
8/77 
C9 
899 
8/78 
/88 
/8/ 
/82 
0/7R 
C9 
/83 8/78 
/84 
/85 
/86 
8/7D 
C9 
/87 
8/7E 
/88 
/89 
//8 8/88 
C9 
1// 
0/8/ 
1/2 
1/3 
//4 8/83 C9 
1/5 
0/84 
1/6 
1/7 


'"'" INITIRLIZE 
TERNINRL DEVICE 
INTERFRCE 
INTRNL 
RET 
RES 
2 


'"'"INITIRLIZE 
PRPER 
TRPE RERDER 
INTERFRCE 
RDRINT 
RET 
RES 
2 


'"'"INITIRLIZE 
PUNCH DEVICE 
INTERFRCE 
PDVINT 
RET 
RES 
2 


'"'" INITIRLIZE 
LISTING 
DEVICE 
INTERFRCE 
LOVCIN 
RET 
RES 
2 
'"'"DETECT 
CONTROL-C 
TYPED ON TERNINRL 
DEVICE 
DTCTCC 
RET 
RES 
2 


'"'"STRRT PRPER 
TRPE RERDER 
RDRSTT 
RET 
RES 
2 
'"'"STOP PRPER 
TRPE RERDER 
RDRSTP 
RET 
RES 
2 


'"'"GET CHRRRCTER 
FRON PRPER 
TRPE RERDER 
GTPCHR 
RET 
RES 
2 


'"'"/JJRITFOR SPRCE ON TERNINRL 
DEVICE 
58 
RET 
RES 
2 


'"'"SEND ONE CHRRRCTER 
TO LISTING 
DEVICE 
CPNT 
RET 
RES 
2 
'"'"PUNCH CHRRRCTER 
ON PUNCH DEVICE 
PCHCHR 
RET 
RES 
2 


'"'"RERD CHRRRCTER 
FROM KEY80RRD 
RNC> ECHO 
RK8 
RET 
RES 
2 


'"'"OUTPUT 
ONE CHRRRCTER 
TO TERMINRL 
DEVICE 
OUT 
RET 
RES 
2 


'"'"RE/JJIND/RESETGENERRL 
INPUT/OUTPUT 
DEVICE 
RE/JJIND RET 
RES 
2 


118 8186 C9 
119 0187 
120 
121 
122 
123 
124 0189 
3E8D 
125 818B 
CD888 
1 
126 818E 
3E8R 
127 81913 CD80131 
128 8193 
3EFF 
129 8195 
CD81301 
1313 8198 C9 
131 
132 
133 
134 
135 
136 
137 
13199 CD8901 
138 1319C 7E 
/39 0190 
FE8D 
148 819F 
C8 
141 81R13 CD8801 
142 81R3 
23 
143 81R4 
C39C01 
144 
145 
146 
147 01R7 
2/8080 
148 81RR 
CD 700 1 
149 81RD 
FE80 
150 13IRF DRCFOI 
151 13/B2 FE8R 
152 8184 
D2CFOI 
153 8187 
E60F 
154 8189 
4F 
155 13IBR RF 
156 81B8 
47 
157 
01BC 
29 
158 81BD 
17 
159 81BE 
54 
160 818F 
50 
/61 13IC8 29 
162 
81CI 
17 
163 81C2 
29 
164 0lC3 
17 
165 
81C4 
19 
166 BIC5 
17 
167 81C6 
09 
168 l'tIC7 17 
169 
81C8 
87 
178 81C9 
CRRR81 
171 81CC 
C3E1382 
172 81CF 
C9 
173 
174 
175 


GDIICIN 
RET 
RES 
2 
****************************************** 
** OUTPUT 
CRRRIRGE 
RETURN 
RND 
LINE 
FEED 
*CRLF 
11111 
CRLL 
11111 
CRLL 
I1VI 
CRLL 
RET 


R, '80 
OUT 
R.. '8R 
OUT 
R, 'FF 
OUT 


** PRINT 
THE 
LINE 
WHOSE 
BEGINNING 
RDDRESS 
* IS 
IN H&L 
ON 
ENTRY. 
C.R./LF. 
PRECEED 


.'#< HERY 
LINE. 
LINE 
TERMINRTES 
WHEN 
* CRRRIRGE 
RETURN 
IS ENCOUNTERED. 


*PRT 
PRT2 
CRLL 
110\1 
CPI 
RZ 
CRLL 
INX 
JMP 


CRLF 
R,M 
'8D 


OUT 
H 
PRT2 
** FETCH 
DECIMRL 
NUMBER 
FROM 
*IDC 
WC2 
LXI 
CRLL 
CPI 
JRL 
CPI 
JGE 
RNI 
110~' 
ZRR 
11011 
DRD 
RRL 
/'10\1 
/'lOll 
ORO 
RRL 
DRD 
RRL 
DRD 
RRL 
DRD 
RRL 
ORR 
JZ 
J/'IP 
RET 


H..a 
RKB 
'B0 
WCRTN 
'8R 
WCRTN 
'F 
C,R 


D,H 
E ..L 
H 


H 


D 


8 


R 
IDC2 
ERR 
WCRTN 
** FETCH 
ONE 
DECIMRL 
NUMBER 
FRO/'lKEYBORRD 
* 


116 81Det CDR181 
117 0 ID3 F£C6 
/18 81D5 C8 
179 8/D6 2R3B82 
188 8109 CD1D81 
181 8IDC C9 
182 
183 
184 
185 
186 
181 
188 
189 
/98 
19/ OIDD CDDB81 
192 8/El~ F5 
193 OIEI 
1C 
194 l~/E2 B5 
195 0lE3 C2EROI 
196 i!I1E6FI 
197 0lE7 C3Ei382 
198 BIER FI 
199 81EB 224F82 
288 81£E FERE 
281 OIFO CRi3002 
202 81F3 FERl~ 
203 81F5 C2E882 
284 81F8 CDD881 
285 OIFB FERE 
286 81FD C2EfJi!l2 
281 8280 225182 
288 
8283 
EB 
289 0284 
1R 
218 8285 2F 
21/ 0286 51 
212 
8287 
78 
213 8288 2F 
214 
8289 
5F 
215 828R 2R4F82 
216 
t128D 
19 
217 828E RF 
218 828F 84 
219 82/13 F2Ei!li32 
228 0213 225382 
221 8216 2R3B82 
222 8219 
19 
223 021R 23 
224 13218 RF 
225 821C 84 
226 821D FREi382 
227 0228 2R4F82 
228 0223 
CDflB82 
229 0226 223D82 
238 8229'E8 
231 822R 223F82 
232 822D 2R5/02 
233 
8238 
CDR882 


PFCH 
CRLL 
IDC 
CPI 
'F' 
LRST LINE? 


RNZ 
LHLD 
LNCNT 
GET IIOF LRST LINE 
CRLL 
RKB 
RND NEXT CHRRRCTER 
RET 


'"'"GET ONE OR TUO DECI~RL NU~BERS 
FROM 
'"Kn'BORRD. 
THESE NUMBERS RRE LEFT IN 
'" "FIRST" RND 
"SECOND". 
THE RDDRESSES 
'"UHICH CORRESPOND 
TO THE FIRST RND 
'"LRST CHRRRCTERS 
OF THE LINE(S) RRE 


.."LEFT 
IN BRDRI RND ERDRI FOR 
"FIRST" 
.."RND BRDR2 RND ERDR2 FOR 
"SECOND" 


'"FPR~ 
CRLL 
PFCH 
GET DECI~RL NUMBER 
PUSH 
PSU 
SRVE LRST CHRRRCTER 
~OV 
R,H 
TEST FOR ZERO 
ORR 
L 
JNZ 
FP/ 
POP 
PSU 
J~P 
ERR 
FPI 
POP 
PSf,/ 
SHLD 
FIRST 
SRVE FIRST LIN£ II 
CPI 
P£RIOD? 


JEQ 
FPRM2 
YeS, SRV£ RS SECOND LIN£ II 
FPRMI 
CPI 
8LRNK? 
IN£ 
£RR 
CRLL 
PFCH 
GCT S£COND LIN£ II 
CPI 
PER.I0D 
IN£ 
ERR 
ERROR 
IF NOT 
FPRM2 
SHLD 
SECOND 
SRVE SECOND LIN£ II 
XCHG 
MOV 
R,D 
CMR 
/'10 
V 
D,R 
FORM ONe'S COMPLEMENT 
MOV 
R..£ 
C/'IR 
MOl,' E,R 
LHLc> FIRST 
DRD 
D 
ZRR 
RDD 
H 
JP 
ERR 
FIRST ) SECOND, ERROR 
SHLD 
IDIFF 
SRVE 
INCLUSIVE DIFF£RENC£ 
LHLc> LNCNT 
DRD 
D 
INX 
H 
ZRR 
RDD 
H 
JM 
ERR 
LHLD 
FIRST 
CRLL 
FBR 
GCT RDDR£SS£S 
FOR 
1ST LIN£ 
SHLc> BRDRI 
SRV£ BEGINNING 
RDDRESS 
XCHG 
SHLD 
£RDRI 
SRV£ ENDING RDDRESS 
LHLD 
S£COND 
CRLL 
FBR 


351 


234 8233 224182 
235 8236 
E8 
236 8237 224382 
237 823R C9 
238 
239 
248 
241 
242 
243 8238 8888 
244 823C>8888 
245 823F 8888 
246 8241 8888 
247 8243 8888 
248 8245 8888 
249 8247 8888 
258 8249 FF8F 
251 8248 8888 
252 824C>8888 
253 824F 8888 
254 8251 8888 
255 8253 8888 
256 8255 8888 
257 8257 8888 
258 8259 81 
259 825R 88 
268 8258 3C 
261 825C 58 
262 825D 88 
263 825E 88 
264 825F 8ll 
265 8260 8888 
266 8262 
267 
268 
269 
278 
271 
272 
273 
274 
275 
276 82RB E8 
277 82RC 2R4582 
278 82RF 7R 
279 8288 83 
288 8281 C2B882 
281 02B4 224882 
282 8287 28 
283 0288 C3C>882 
284 8288 
18 
285 828C 7R 
286 828C>83 
287 828E CRC882 
288 82CI 7E 
289 82C2 23 
298 82C3 FE8C> 
291 82C5 CR8882 


********************************** 
* DRTR RRER 
********************************* 
*LNCNT 
C>8L 
BRC>RI 
C>BL 
ERC>RI 
DBL 
BRDR2 
C>8L 
ERC>R2 
DBL 
BFR 
C>BL 
8FR 
DBL 
EOB 
D8L 
LRDR 
DBL 
EOLRDR 
DBL 
FIRST 
DBL 
SECOND 
DBL 
IDIFF 
D8L 
NXTCHR 
DBL 
TEMP 
DBL 
FLRG 
DRTR 
LRSTIN 
*** 


LDRS1Z 
DRTR 
68 
TRLSIZ 
DRTR 
88 
PFLRG 
*** 
RCNT 
*** 
NULLS 
*** 
DCNT 
DBL 
8 
KB 
RES 
73 
********************************* 
** FIND 8UFFER RDDRESSES FOR LINE "'HOSENUM8ER 
* IS IN H&L ON ENTRY. RDDRESS OF 1ST CHRRRCTER 
* IS LEFT IN LRDR, RDDRESS OF TERNINRTING C.R. 
* IS LEFT IN EOLRDR. BEGINNING RDDRESS 
* IS RLSO IN H&L ENDING RDDRESS IN D&E. 
*F8R 


SHLD 
BRDR2 
XCHG 
SHLD 
ERDR2 
RET 


SRVE BEGINNING RDDRESS 


SRVE ENDING RDDRESS 


8 
8 
8 
tl 
8 
tl 
8 
'8FFF 
8 
8o 
8 
8 
8 
8 
I 


XCHG 
LHLD 
1'10 V 
ORR 
JNZ 
SHLD 
DCX 
J1'IP 
DCX 
1'I0V 
ORR 
JZ 
1'I0V 
INX 
CPI 
JEQ 


BFR 
R,D 
E 
FBRI 
LRDR 
H 
F8R5 
D 
R,D 
E 
F8R3 
R,1'I 
H 
'8D 
F8RI 


292 
82C8 
C3C 182 
293 
82C8 
224882 
294 
82CE 
7E 
295 
82CF 
FE8D 
296 
82DI 
CRD802 
297 
82D4 
23 
298 
82D5 
C3CE82 
299 
82D8 
224D82 
388 
82DB 
E8 
381 
82DC 
2R4882 
382 
82DF 
C9 
383 
384 
385 
386 
82E8 
3EBF 
387 
82E2 
CD8881 
388 
82E5 
318881 
389 
82E8 
C31981 
318 
311 
312 
313 
82EB 
CD7D81 
314 
82EE 
FERE 
315 
82F8 
C2E882 
316 
82F3 
2R47l'l2 
317 
82F6 
224582 
318 
82F9 
225582 
319 
82FC 
218888 
328 
82FF 
223B82 
321 
8382 
RF 
322 
8383 
325982 
323 
8386 
C31981 
324 
325 
326 
327 
8389 
CD8681 
328 
838C 
3E81 
329 
838E 
C31283 
338 
l'l311RF 
331 
8312 
325D82 
332 
8315 
CDDD81 
333 
8318 
3R5D82 
334 
831B 
B? 
335 
831C 
CR3483 
336 
831F 
215EII 
337 
8322 
CD9901 
338 
8325 
3R5B02 
339 
8328 
47 
348 
8329 
CD?481 
341 
832C 
RF 
342 
832D 
CD7R81 
343 
83313 85 
344 
8331 
C22D03 
345 
0334 
CD898 1 
346 
0337 
CD6881 
347 
833R 
DRI9131 
348 
033D 
2R4F02 
349 
8348 
23 


FBR3 
FBR4 


J/'IP 
SHLD 
/'IOV 
CPI 
JEQ 
INX 
JI'/P 
SHLD 
XCHG 
LHLD 
RET 


FBR2 
LRDR 
R .•/'I 
'SD 
FBR5 
H 
FBR4 
EOLRDR 


LRDR 


'"'"ERROR 
ENTR~' 
*ERR 
/'IVI 
CRLL 
LXI 
J/'IP 


fl" /?/ 
OUT 
SP ../'ION 
/'ION2 
** INITIRLIZRTION 
*CLERR 
CRLL 
CPI 
JNE 
LHLD 
SHLD 
SHLD 
LXI 
SHLD 
lRR 
STR 
J/'IP 


ERR 
BFR 
BFR 
NXTCHR 
H,8 
LNCNT 


FLRG 
/'ION2 


GET 
BUFFER 
RDDRESS 


SET 
POINTER 
TO B.O.B. 


lRP 
LINE 
COUNT 


CLERR 
STRRT 
FLRG 


** LIST 
RND 
PUNCH 
FUNCTIONS 


'"PUNCH 
CRLL 
/'II/I 
J/'IP 
lRR 
STR 
CRLL 
LDR 
ORR 
JZ 
LXI 
CRLL 
LDR 
/'101/ 
CRLL 
lRR 
CRLL 
DCR 
JNl 
CRLL 
CRLL 
JC 
LHLD 
INX 


GDVCIN 
R,I 
L2 


PFLRG 
FPR/'I 
PFLRG 
R 
L3R 
H ..RDP/'ISG 
PRT 
LDRSIZ 
B,R 
5B 


PCHCHR 
8 
L3 
CRLF 
DTCTCC 
/'ION2 
FIRST 
H 


SET 
LIST/PUNCH 
FLRG 
GET 
LI/'IITS 
LIST 
OR 
PUNCH 


GET 
LERDER 
LENGTH 
WRIT 
FOR 
SPRCE 
BRR 


PRGE 
87 
Z88 
RESIDENT 
EDITOR/RSSEMBLER 


358 
8341 
224F82 
SHLD 
FIRST 
RND 
REPLRCE 
351 
8344 
2B 
DCX 
H 
352 8345 3R5Dt12 
LDR 
PFLRG 
353 8348 B7 
ORR 
R 
CONVERT 
LINE 
NUMBER? 
354 
8349 
C27R83 
JNZ 
L5 
355 
834C 
1118FC 
LXI 
D,-/1380 
356 
('134FCDD7133 
CRLL 
CONVI 
357 8352 
119CFF 
LXI 
D ..-188 
358 8355 CDD783 
CRLL 
CONVI 
359 8358 
IIF6FF 
LXI 
D ..-18 
360 
835B 
CDD7lU 
CRLL 
CONVI 
361 
835E 
IIFFFF 
LXI 
D,-I 
362 
0361 
CDD783 
CRLL 
CONVI 
363 8364 3ER8 
MVI 
R 
/ 
/ 
PRINT 
BLRNK 
.' 


364 8366 
CD8l181 
CALL 
OUT 
365 13369 2R3D82 
LHLD 
BRDRI 
366 t136C CD2 I06 
CALL 
FORMRT 
367 
836F 
219D87 
LXI 
H ..LR8EL 
368 8372 
3E8D 
/'IVI 
A, '8D 
369 8374 
32DI87 
STR 
HEX+72 
378 lU77 C37Dt13 
J/'IP 
L5A 
37/ 837R 
2R3D82 
L5 
LHLD 
BRDRI 
372 
837D 
3R5Dl12 
L5R 
LDA 
PFLAG 
373 
8380 
B7 
ORR 
R 
374 8381 
CR9683 
JZ 
L5RB 
375 
13384 7E 
L5AI 
/'IOV 
R.oM 
376 8385 CD7R81 
CRLL 
PCHCHR 
377 8388 23 
INX 
H 
378 8389 FE8D 
CPI 
'8D 
379 
838B 
C28483 
JNE 
L5RI 
388 
838E 
3E8R 
/'I~'I A ..'8A 
381 
8398 
CD7R81 
CRLL 
PCHCHR 
382 0393 
C3RF83 
J/'IP 
L5C 
383 8396 
7E 
L5R8 
/'10V 
R,/'I 
384 lU97 CD8881 
CRLL 
OUT 
385 
839A 
23 
INX 
H 
386 8398 FE8D 
CPI 
'8D 
CRRRIRGE 
RETURN 
387 
839D 
C29683 
JNE 
L5RB 
388 
83R8 
3E8R 
/'IVI 
A, '8R 
389 
83R2 
CD8881 
CRLL 
OUT 
39tl 83R5 
2A3D82 
LHLD 
8RDRI 
391 
83R8 
7E 
L5B 
/'IOV 
~//'1 
392 t13R9 23 
INX 
H 
393 
83RA 
FE8D 
CPI 
'8D 
394 tURC 
C2R883 
JNE 
L58 
395 
83RF 
223D82 
L5C 
SHLD 
BRDRI 
396 t1382 2R5382 
LHLD 
IDIFF 
397 
83B5 
23 
INX 
H 
398 8386 225382 
SHLD 
IDIFF 
399 8389 
7C 
/'10V 
R ..H 
4t18 838A 
B7 
ORA 
A 
481 
838B 
FA3783 
J/'I 
L4 
482 
838E 
3A5D82 
LDR 
PFLRG 
483 
83CI 
B7 
ORR 
R 
484 t13C2 CAD483 
JZ 
L? 
485 
83C5 
3R5C82 
LDR 
TRLSIZ 
GET 
TRRILER 
SIZE 
486 tUCS 47 
/'IO~' B,A 
487 
83C9 
RF 
ZRR 


354 


488 
03CA 
C07A01 
489 
83CO 
85 
41 tl 03CE 
C2CA03 
411 
03D I C0748 
1 
412 
0304 
C31601 
413 
414 
415 
416 
8307 
CDDE03 
417 
83DA 
CDSOOI 
4/8 
03DD 
C9 
4/9 
83DE 
8688 
420 
03Etl 225702 
42/ 
83E3 
19 
422 
83E4 
7C 
423 
83E5 
87 
424 
83E6 
FAED03 
425 
83E9 
84 
426 ll3EA C3E003 
427 
03ED 
2A5782 
428 
83Ftl 78 
429 
83FI 
C9 
430 
431 
432 
433 
83F2 
CDDDO/ 
434 
83F5 
2A3802 
435 ll3F8 E8 
436 
03F9 
2A5382 
437 
83FC 
19 
438 
03FD 
223882 
439 8408 
2A5/82 
448 8403 
CD3384 
44/ 8486 
19 
442 0407 
7C 
443 8408 85 
444 t1409 C21504 
445 
848C 
2A3D82 
446 ll40F 225502 
447 0412 
C3/901 
448 
0415 
2A4302 
449 
0418 
23 
458 
0419 
EB 
45/ 
841A 
2A5502 
452 
841D 
CD3304 
453 042(~ 19 
454 
8421 
44 
455 8422 
4D 
456 0423 
2R3D02 
457 8426 
/A 
458 
0427 
77 
459 8428 
13 
468 8429 23 
461 
842R 
03 
462 ll428 78 
463 
842C 
81 
464 
042D 
C22604 
465 04J8 CJ8F04 


L6 
CALL 
PCHCHR 
DCR 
8 
JNZ 
L6 
CALL 
S8 
L7 
HIP 
/'ION1 
** CONIIERTER 
*CONIII 
CRLL 
CNIIDEC 
CALL 
OUT 
RET 
CNIIDEC 
MVI 
8,'0' 


CONI/IR 
SHLD 
TE/'IP 
DAD 
D 


/'10'1' 
A ..H 
ORA 
A 
J/'I 
CONII2 
INR 
8 
J/'IP 
CONIIIA 
CON~'2 
LHLD 
TE/'IP 
/'lOll A,8 
RET 
** DELETE 
FUNCTION 
*DELETE 
CALL 
FPR/'I 
GET 
DELETE 
LI/'IITS 
LHLD 
LNCNT 
XCHG 
LHLD 
IDIFF 
DAD 
D 
CO/'IPUTE NEW 
LINE 
COUNT 
SHLD 
LNCNT 
LHLD 
SECOND 
CALL 
NEGHL 
DAD 
D 
CO/'IPUTE LINECOUNT 
- SECOND 


/'10'1' 
R ..H 
ORA 
L 
TEST 
FOR 
ZERO 
JNZ 
DLI 
INCLUDE 
LRST 
LINE? 
LHLD 
8ADRI 
YES ..SET 
NEW 
END 
DLtl 
SHLO 
NXTCHR 
J/'IP 
MON2 
DLI 
LHLD 
EADR2 
ADDRESS 
OF 
FIRST 
CHAR 
INX 
H 
OF 
LINE 
TO 8E 
/'lOVED DOWN 
XCHG 
"FRO/'/"POINTER 
TO D&E 
LHLO 
NXTCHR 
CRLL 
NEGHL 
DAD 
D 
FOR/'ICOUNT 
TO 8E 
/'lOVED 
/'lOll 8 ..H 
/'lOll C ..L 
LHLD 
8ADRI 
"TO" 
ADDRESS 
TO H&L 
DL2 
LOAX 
D 
GET 
CHARACTER 
/'lOll /'I,R 
/'lOVEIT 
DOWN 
INX 
D 
INCREMENT 
"FRO/'l"POINTER 
INX 
H 
INCRE/'IENT "TO" 
POINTER 
INX 
8 
INCREMENT 
COUNT 
/'lOll A,8 
ORA 
C 
TEST 
FOR 
ZERO 
COUNT 
JNZ 
DL2 
J/'IP 
DW 


355 


466 
467 
468 
469 
8433 
7C 
470 
tl434 
2F 
47/ 0435 67 
472 
8436 
7D 
473 
8437 
2F 
474 
8438 
6F 
475 
8439 
23 
476 843R C9 
477 
478 
479 
488 
8438 
CDD881 
481 843E FERE 
482 
8448 
C2E082 
483 
0443 
CD8901 
484 
8446 224F82 
485 
8449 
E8 
486 844R 2R3882 
487 844D CD3384 
488 
8458 
19 
489 0451 28 
498 
8452 
7C 
491 8453 
87 
492 
8454 F2EfJ82 
493 
494 
8457 
E8 
495 
8458 
CDRB82 
496 845B 13 
497 845C EB 
498 845D 224D82 
499 
0460 
216282 
588 
8463 
3E48 
581 8465 
325E82 
582 
8468 CD8981 
503 
584 
8468 CD7D81 
505 046E FE8A 
586 
8478 CR6B84 
507 
0473 
FEFF 
588 
8475 
CR6B84 
589 
8478 FERE 
518 847A CRI981 
51/ 847D FE8D 
5/2 847F CR6884 
513 0482 FEDF 
514 8484 
CR6884 
515 0487 
C39C84 
516 848A CD7D81 
517 848D FE8A 
518 848F CA8R84 
5/9 
8492 FEFF 
528 0494 CR8R84 
521 0497 
FEDF 
522 
8499 CR8384 
523 949C 77 


.'/< 


.'/< NEGATE THE /6 BIT NUMBER IN H&L 
.'/< 
NEGHL 
MOil 
A,H 
CMA 
MOV 
H..R 
MOil 
R,L 
C/'/A 
MOil 
L,.R 
INX 
H 
RET 
.'/< 


.'/< RDD FUNCTION 
.'/< 
RDD 


RD/R 
RDD/ 
ADD2 


XCHG 
CRLL 
INX 
XCHG 
SHLD 
LXI 
/,/VI 
STR 
CRLL 
EQU 
CRLL 
CPI 
JEQ 
CPI 
JEQ 
CPI 
JEQ 
CPI 
JEQ 
CPI 
JEQ 
JMP 
CRLL 
CPI 
JEQ 
CPI 
JEQ 
CPI 
JEQ 
/'/0 V 


CRLL 
CPI 
JNE 
CRLL 
SHLD 
XCHG 
LHLD 
CALL 
DRD 
DCX 
MOV 
ORA 
JP 


ERR 
CRLF 
FIRST 


LNCNT 
NEGHL 
D 
H 
A,H 
A 
ERR 


GET LINE NUMBER 
PROPER 
TERMINRTOR? 


GET LINECOUNT 


FORM LINEit - LINECOUNT 
-I 


SET FLRGS 
IF THIS JUMP TRKES PLRCE 
THE LINE # NAS ) LINECOUNT 
LINE fi TO H-L 
GET LINE ADDRESSES 
FORM ADDRESS OF BEGINNING OF 


SRVE 


GET CHRRRCnR 
COUNT/LINE 


BRCK RRRON? 


LEGRL INPUT 
GET CHRRRCTER 


BRCKSLRSH 


CHARACTER 
TO BUFFER 


FBR 
D 


EOLRDR 
H,KB 
R..?2 
RCNT 
CRLF 
RD/R 
RKB 
'8A 
RDD2 
'FF 
RDD2 


MON2 
'8D 
RDDI 
:DF 
RDDI 
RDD4 
RKB 
'8A 
RDD3 
:FF 
RDD3 
'DF 
RDD5 
/'/,R 


524 
8490 
23 
INX 
H 
525 
849E 
FE80 
CPI 
'80 
526 
04RO 
CRCR04 
JEQ 
R006 
527 
84R3 
3R5E02 
LC>R 
RCNT 
528 
84R6 
30 
OCR 
A 
ENO 
OF LINE? 
529 
04R7 
325E02 
STR 
RCNT 
530 
04RR 
C28R04 
JNZ 
ROD3 
531 
04RO 
C0898 1 
CRLL 
CRLF 
532 
0480 
C3CR04 
J/'fp 
RDD6 
533 
0483 
28 
RDD5 
OCX 
H 
534 
0484 
E8 
XCHG 
535 
0485 
219EFO 
LXI 
H ..-K8 
536 
0488 
19 
DRD 
0 
537 8489 
7C 
/'fOV 
R,H 
538 
048R 
85 
ORR 
L 
539 8488 
CR6804 
JZ 
RDD8 
540 
848E 
E8 
XCHG 
541 
848F 
CD7D81 
CRLL 
RK8 
542 
84C2 
FE8D 
CPI 
'80 
543 
84C4 
CR6084 
JEQ 
RD08 
544 
84C7 
C38084 
J/'fp 
RDD3R 
545 
84CR 
f8 
RD06 
XCHG 
546 t14C8 219EFD 
LXI 
H,-KB 
547 
84CE 
19 
ORO 
D 
548 
04CF 
4D 
/'fOil C ..L 
549 
84D8 
44 
/'fOil 8 ..H 
550 
t14DI 226802 
SHLC> 
DCNT 
551 
04D4 
2R5582 
RDD7 
LHLC> 
NXTCHR 
GET 
OLD 
NXTCHR 
552 
04D7 
t19 
DRD 
8 
FOR/'fNEW 
NXTCHR 
553 
84D8 
E8 
XCHG 
SRllE 
554 
8409 
3R4982 
LOA 
£08 
CHECK 
FOR 8UFFER 
OVERFLOW 
555 
040C 
93 
5U8 
£ 
556 
INDO 
3R4A82 
LDR 
£08+/ 
557 84£8 9R 
588 
D 
558 
84£1 
DA2905 
JC 
8FL 
8UFF£R 
OVERFLOI4 
559 
04E4 
88 
NOP 
560 
84E5 88 
NOP 
561 
'" 
562 
'" CO/'fPUTE /'fOllERDDRESSES 
563 
'" 
564 
84E6 
2A5502 
LHLD 
NXTCHR 
565 
84E9 
£8 
XCHG 
566 
84ER 
225582 
SHLC> 
NXTCHR 
UPDRTE 
NXTCHR 
567 
84ED 
44 
/'fOV 
8,H 
568 
04EE 
4D 
/'fOil C..L 
569 
84£F 
2R4D82 
LHLC> 
EOLRDR 
CHECK 
FOR 
LRST 
LINE 
578 
84F2 
CD3384 
CRLL 
NEGHL 
571 
84F5 
19 
DRD 
D 
572 
84F6 
7C 
/'fall R,H 
573 
04F7 
85 
ORR 
L 
574 
t14F8 CR0785 
JZ 
RDDI8 
575 
84F8 
18 
DCX 
D 
576 
04FC 
88 
DCX 
8 
577 
84FD 
IR 
RDD9 
LDRX 
D 
578 
84FE 
82 
STRX 
8 
579 
84FF 
88 
DCX 
8 
580 
8588 
18 
DCX 
D 
581 
8581 
28 
DCX' 
H 
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582 8582 
7C 
583 8583 85 
584 8584 C2FD84 
585 8587 816202 
586 
051.~R2R4D82 
587 
050D 
E8 
588 
050E 
2R6002 
589 
0511 
OR 
591.10512 
12 
591 
0513 
83 
592 
1.151413 
593 
0515 
28 
594 
1.15167C 
595 
0517 
85 
596 
0518 
C211l:15 
597 
0518 
2R3802 
598 
851E 
23 
599 
051F 
223802 
680 
0522 
2R4F82 
601 
0525 23 
682 
0526 
C34684 
683 0529 213205 
684 
852C 
CD99fJI 
605 
052F 
C31981 
606 
8532 C2D5C6C6 
687 
853D 
8D 
6fJ8 
689 
61fJ 
61 I 853E 
CDrD81 
612 
8541 
FERE 
613 
8543 C2E882 
614 
8546 CD83fJI 
615 
8549 RF 
616 
854R 
325FfJ2 
617 
854D 
CD5FfJI 
618 
fJ55fJCDC5fJ5 
619 
8553 DRI9fJ/ 
620 0556 216202 
621 
0559 
E8 
622 
055R 
2R55fJ2 
623 
055D 
3R4982 
624 
0568 
95 
625 856/ 
4F 
626 
0562 
3R4RfJ2 
627 8565 9C 
628 8566 BI 
629 8567 CR2905 
63fJfJ56R IR 
631 
0568 
?7 
632 
fJS6C 23 
633 
856D 
13 
634 
056E 
05 
635 
856F 
C25D85 
636 
0572 
225582 
637 
0575 
2R3Bel2 
638 8578 23 
639 8579 223802 


/'IO~' 
ORR 
JNZ 
LXI 
LHLD 
XCHG 
LHLD 
lORX 
STRX 
INX 
INK 
DCX 
NOll 
ORR 
JNZ 
LHLD 
INX 
SHlO 
LHLD 
INX 
JNP 
LXI 
CRLL 
J/'IP 
RSC 
DATA 


R.•H 
L 
RDD9 
B ..KB 
EOLROR 


DCNT 
8 
/'lOVEIN NEW 
LINE 
D 
B 
D 
H 
R..H 
L 
RDDII 
LNCNT 
H 
LNCNT 
FIRST 
H 
NKT 
H,8FLR 
PRT 
~ION2 
"BUFFER 
FULL / 
'8D 
** RERD 
FUNCTION 


>/< 
RERD 
CRLL 
RKB 
GET 
PERIOD 
CPI 
JNE 
ERR 
CRLL 
REWIND 
ZRR 
STR 
NULLS 
CRLL 
RDRINT 
R2 
CRLL 
RTR 
JC 
NON2 
LXI 
H ..KB 
XCHG 
LHLD 
NXTCHR 
R6 
lOR 
EOB 
SUB 
L 
/'10 
V 
LR 
LDR 
EOB+I 
SBB 
H 
ORR 
C 
JZ 
BFL 
lORX 
D 
/'10 
V 
/'I 
..R 
INX 
H 
INX 
D 
OCR 
B 
JNZ 
R6 
SHLD 
NXTCHR 
LHlO 
LNCNT 
INX 
H 
SHLD 
LNCNT 
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648 
851C 
CD6801 
641 
851F 
DAI901 
642 
0582 
C35005 
643 
8585 
644 
645 
646 
641 
0599 
CD1101 
648 
t159C F680 
649 
859E 
FEFF 
65tl 
tl5Rtl CR9905 
651 
05A3 
FE8A 
652 
05R5 
CR9905 
653 
05A8 
FE80 
654 
05RR 
CRB605 
655 
05AD 
F5 
656 
85RE 
JEfJR 
651 
85B8 
325F82 
658 
85B3 
FI 
659 
0584 
81 
56€.1€.I585C9 
661 
0586 
3A5F02 
652 l~5B930 
663 
1358A 325F82 
664 
8580 
C299t15 
665 
05CO 
C06E81 
666 
€.I5C331 
661 
135C4 C9 
668 
669 
618 
611 
85C5 
216282 
612 
85C8 
13688 
613 
05CA 
C06801 
614 
85CO 
C09985 
615 
135D8 08 
616 
8501 
FEAI 
611 
0503 
C2FA135 
618 
8506 
C01181 
619 
05D9 
C01101 
688 
850C 
C01181 
681 
050F 
C06EOI 
682 
85E2 
C01081 
683 
05E5 
FE83 
684 
f.l5E1CRI981 
685 
05EA 
FEAO 
686 
l~5EC C2E205 
681 
05EF 
RF 
688 
05FO 
325Ft12 
689 
05F3 
C3C585 
698 
05F6 
C09905 
691 
05F9 
08 
692 
05FR 
11 
693 
f35F8 23 
694 
85FC 
04 
695 
05FO 
FE80 
696 
05FF 
CRI606 
697 8682 18 


CRLL 
OTCTCC 
JC 
/'ION2 
J/'IP 
R2 
RES 
28 


'"'"REAO 
CHRRACTER 
FRO/'lREAOER 
'"RCH 
CALL 
GTPCHR 
GET 
FRANE 
FRON 
PTR 
ORI 
'88 
CPI 
'FF 
JEl~ 
RCH 
CPI 
'8R 
JEQ 
RCH 
CPI 
'88 
JEQ 
RCH2 
PUSH 
PSN 
I'll/I R ..18 
STA 
NULLS 
POP 
PSN 
RSC 
RET 
RCH2 
LOR 
NULLS 
DCR 
R 
STA 
NULLS 
JNZ 
RCH 
CRLL 
RORSTP 
STC 
RET 


'" 
'" 
RERO 
PRPER 
TAPE 
RECORD 
FRON 
RERDER 


'"RTR 
LXI 
H ..K8 
/'II/I 
B ..0 
CALL 
RORSTT 
CALL 
RCH 
RC 
CPI 
'I' 
CHECK 
FOR 
END 
OF 
TAPE 
JNE 
R3R 
RTRB 
CRLL 
GTPCHR 
CALL 
GTPCHR 
CRLL 
GTPCHR 
CALL 
RORSTP 
RTRCZ 
CALL 
RKB 
CPI 
'83 
JEQ 
NON2 
CPI 
JNE 
RTRCZ 
ZRR 
STR 
NULLS 
J/'IP 
RTR 
R3 
CALL 
RCH 
RC 
R3R 
/'101/ 
/'I,R 
INX' 
H 
INR 
8 
CPI 
'80 
JEl~ 
R5 


/'101/ 
R,B 
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698 8683 FE48 
699 8685 
C2F685 
780 8688 3E80 
781 868A 
32AA82 
782 
8600 
C09985 
783 
8618 
D8 


7(~4 861 I FE80 
785 
8613 
C28D86 
786 8616 
78 
707 
8617 
FE81 
788 8619 
CAC585 
789 
861C 
C06E81 
118 
861F 
87 
711 8628 
C9 


'1/2 
713 
714 
715 
716 
717 8621 
AF 
718 8622 328687 
719 8625 
1648 
728 8627 818987 
721 862A 
3ER8 


722 862C 
82 
723 
8620 
83 
724 862E 
15 
725 862F 
C22C86 
726 
727 8632 3EFF 
728 8634 328507 
729 8637 328407 
738 
731 
863A 
7E 
732 8638 328387 
733 
863E 
FEAA 
734 8648 CA6E87 
735 8643 FERt'! 
736 8645 CA7106 
737 
738 8648 819087 
739 8648 
/686 
748 8640 
7E 
741 864E 
FEA8 
742 8650 CA7186 
743 8653 82 
744 8654 23 
745 8655 83 
746 8656 FE8D 
747 8658 CA5287 
748 0658 
15 
749 86SC 
C24D86 
758 
751 
86SF 
7E 
752 8668 23 
753 8661 
FER0 
754 8663 CA7186 
755 8666 FE80 


".. 
"..FOLLOWING 
ROUTINE 
FORMATS 
THE RECORO 


"..WHOSE 
ADORESS 
IS 
IN H&L 
ON ENTR~·. RESUL T 
"'"IS LEFT 
IN HEX, 
HEX+7/ 


"'"FORMAT 
ZAR 
STR 
RTNFLG 
/'IVI 
0,72 
LXI 
8,HEX 


/'IVI 
A," 


STRX 
8 
INX 
8 
OCR 
0 
JNZ 
FRMI 


CPI 
JNE 
/'IVI 
STR 
CRLL 
RC 
CPI 
JNE 
MOV 
CPI 
JEQ 
CALL 
RSC 
RET 


LXI 
Mill 
/'10 V 
CPI 
JEQ 
STAX 
INX 
INX 
CPI 
JEQ 
OCR 
JNZ 


/'lOll 
INX 
CPI 
JEQ 
CPI 


R3 
A.. '80 
K8+72 
RCH 


:8D 
R4 
A..8 
I 
RTR 
RORSTP 


/'IVI 
A,-I 
STA 
SKEL 
STA 
CLASS 


MOil 
A,/'I 
STA 
CHI 
CPI 
''''"' 


JEQ 
XCLINE 
CPI 
JEQ 
XOP 


8 ..LA8EL 
0,6 
A,N 


XOP 
8 
H 
8 
'80 
ENOFMT 
o 
FRM2 


A,/'I 
H 


XOP 
'80 


SET 
NULL 
INSTRUCTION 
SKELETON 
ANO 
CLASS 


GET 
FIRST 
CHARRCTER 
SAVE 
FIRST 
CHARACTER 
CO/'IMENTLINE? 
~'ES 
NO, 
LABEL 
PRESENT? 


NO 


TRANSNIT 
LA8EL 


PRGE 
14 
Z80 
RESIDENT 
EDITOR/RSSE/'I8LER 


756 
l't668 
C25F06 
JNE 
TR 
757 
0668 
32A307 
STA 
LA8EL+6 
SET 
C.R. 
758 
066E 
C3'52l17 
J/'IP 
ENDF/'tT 
759 
:I< 
760 
l167I 
7£ 
XOP 
/'tOil 
A,/'t 
SCAN 
PRST 
8LANKS 
TO 
761 
8672 
FERO 
CPI 
FIND 
I'1NEI'10NIC 
762 
8674 
C27886 
JNE 
XOPI 
763 
8677 
23' 
INX 
H 
764 
8678 
C3'7I06 
JI'1P 
XOP 
765 
8678 
1604 
XOPI 
/'till 
D,4 
TRANSI'1IT /'INEI'10NIC 
766 
067D 
0lA587 
LXI 
8 ..I'1NEI'1 
767 
8688 
7E 
FR/'I3 
/'lOll A,/'t 
768 
l't6$1 FEA0 
CPI 
769 
0683' CAA786 
JEQ 
LUOP 
EX IT 
ON 
8LANK 
770 
l1686 FE8D 
CPI 
:8D 
771 
0688 
CRRI06 
JEQ 
FR/'I5 


172 8688 
f12 
STAX 
8 
773' 868C 
23' 
INX 
H 
774 
068D 
03' 
INX 
8 
775 
068E 
15 
DCR 
D 
776 
868F 
C28006 
JNZ 
FRI'13' 
777 
0692 
7E 
FR/'I4 
/'101/ 
A,I'1 
WRSTE 
EXCESS 
I'1NEI'10NIC 


778 
8693 
23 
INX 
H 


779 
0694 
FE8D 
CPI 
:8D 
788 
l't696 
CAR Il16 
JEQ 
FRI'15 
781 
0699 
FER8 
CPI 


782 
8698 
CAA706 
JEQ 
LUOP 
783' 069E 
C39206 
J/'IP 
FR/'I4 
784 
06AI 
3286l':f? 
FRI'15 
STA 
RTNFLG 
SET 
FLAG 
785 
06R4 
3'2A9l't7 
STA 
/'tNE/'t+4 
786 
:I< 
787 86R7 228'107 
LUOP 
SHlO 
HSAVE 
SAllE POINTERS 


788 
l16AA 2AA707 
LHlO 
/'INEI'1+2 
789 
06RD 
E8 
XCHG 
79l't 06AE 
2AA587 
LHlO 
MNEI'1 
791 
8681 
CDD287 
CALL 
OPSRC 
LOOK 
UP 
NNEMONIC 
792 
l't6B4 2284t't7 
SHlO 
CLASS 
SRIlE SkELETON 
& 
CLASS 
793 
8687 
3A8687 
lOA 
RTNFLG 
794 868A 
87 
ORA 
A 
795 
t1688 C25207 
JNZ 
ENDFMT 
796 
868E 
55 
I'10\l 
D ..L 
SAVE 
CLASS 
IN 
D 
797 
068F 
2R87f!7 
LHLD 
HSAVE 
798 
06C2 
7E 
FR/'I6 
/'lOll 
A ../'I 
WASTE 
8LANKS 


799 
86C3 
23 
INX 
H 
80t't 86C4 
FEAO 
CPI 
801 
06C6 
CAC206 
JEQ 
FRM6 


802 
06C9 
FE8D 
CPI 
:8D 
883' 86CB 
C2D406 
JNE 
FRI'17 
8114 t16CE 3'2A98? 
STA 
MNE/'I+4 
885 
(~6DI C3'5287 
J/'IP 
ENDF/'IT 
8116 
*" 
887 
06D4 
28 
FR/'I7 
DCX 
H 
808 
06D5 
7R 
/'tOil 
A ..D 
889 
86D6 
110008 
LXI 
D ..0 
810 
06D9 
87 
ORA 
A 
CHECK 
FOR 
PRESENCE 
OF 
S/I 
06DA 
FA IAlP 
JI'1 
FRf'1I2 
OPERAND 
812 
06DD 
ll1A887 
LXI 
8 ..0PNDF 
813 
t16E8 C2E886 
JNZ 
FRI'1S 
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814 
86E3 
3R8581 
815 
86E6 
FE83 
816 
86E8 
CR5981 
811 
818 
86E8 
1E 
819 
86EC 
FE8D 
82t1 86EE 
CRI687 
821 
86F I FER1 
822 
86F3 
C2FE86 
823 
36F6 
18 
824 
ll6F'1 2F 
825 
86F8 
5F 
826 
86F9 
3ER'1 
821 
36F8 
C38Rt11 
828 
86FE 
FERt1 
829 
8'180 C20R0'1 
838 
8'183 18 
831 
0184 
81 
832 
8185 
CRIR8'1 
833 
8188 
3ER0 
834 
818R 
ff2 
835 
8188 
23 
836 
8'18C 83 
831 
018D 
14 
838 
8'18E 7R 
839 
818F 
FE26 
848 ll1II C2E886 
841 
0114 
3E8D 
842 
fJ116 82 
843 
8717 
C35207 
844 
845 
846 
fJ71R '1E 
847 
8718 
FE8D 
848 
ll'1lDCRI6l17 


849 
8728 
FER0 
858 
9722 
C22987 
851 
8725 
23 
852 
8726 
C31RfJ'1 
853 
8729 
1R 
854 
8'12R lllfl800 
855 
872D 
FE8R 
856 
ll'12F FR35fJ? 
857 8732 
DE89 
858 
fJ734 4F 
859 
8135 
EB 
8611 fJ736 218587 
861 
8739 
89 
862 
873R 
812FF8 
863 
013D 
228101 
864 
874fJ 89 
865 
814/ 
1C 
866 
8742 
85 
867 
8743 
F25287 
868 
8746 
45 
869 
8147 
2R81137 
878 
fJ'14RIR 
871 
8748 
7? 


LDR 
CPI 
JEQ 


NOll 
CPI 
JEl~ 
CPI 
JNE 
INX 
JNP 
NOV 
LXI 
CPI 
J( 
S8I 
NOll 
XCHG 
LXI 
DRD 
LXI 
SHLD 
DRD 
MOV 
ORR 
JP 
/'10 V 
LHLD 
LDRX 
/'10 V 


SKEL 
CHECK 
FOR 
TITL 
3 
X/'ITTL 


/'101/ 
CPI 
JEQ 
CPI 
JNE 
/'10 V 
C/'IR 
/'10 V 
/'IVI 
J/'IP 
CPI 
JNE 
/'10 V 
ORR 
JZ 
/'IV I 
STAX 
INX 
INX 
INR 
/'10 V 
CPI 
JNE 
/'IV I 
STAX 
J/'IP 


R,/'I 
'8D 
FR/'III 
'R7 
RPOSTROPHE? 


FR/'I9 
R..E 


E,R 
SET 
RPOSTROPHE 
FLRG 
A.. :R7 
FR/'IIO 


FRI'11tl 
R ..E 
R 
FR/'II2 
A.I/ 
..- 


B 
H 
8 
D 
R ..D 
38 
FR/'I8 
R, '8D 
8 
ENDFMT 


R ../'I 
'8D 
FR/'III 


FR/'II2R 
H 
FR/'II2 
R,D 
8,0 
10 
XCF 
9 
COMPUTE 
CO/'INENT STRRT 
C.'R 
RDDRESS 


H ..CFLD 
8 
B ..-HEX-?2 
HSRVE 
8 
R,H 
L 
ENDF/'IT 
NO 
ROO/'lFOR 
CO/'l/'lENT 
8,L 
HSRVE 
D 
N,R 
/'IOIlECO/'l/'lENT 


872 
874C 
13 
873 
874D 
23 
874 
874E 
84 
875 
874F 
C24R07 
876 8752 
2R848? 
877 0755 JR8387 
878 8758 C9 
879 
888 
881 
882 8759 
1626 
883 
0758 
0/RB87 
884 
875E 
7E 
885 
075F 
82 
886 
0761:.123 
887 
0761 
03 
888 8762 FE8D 
889 8764 CR6B07 
898 8767 
15 
891 
0768 
C25E87 
892 
876B 
C35287 
893 
894 
895 
896 t176E 1634 
897 0770 819D07 
898 8773 
7E 
899 8774 82 
980 8775 23 
981 
8776 83 
9l=t2 t:l7?? 
FESD 
983 8779 
CR5207 
984 tl77C 15 
985 
877D 
C27307 
9t16 8788 C352t17 
987 
988 l~783 88 
909 8784 88 
918 
8785 t18 
911 
8786 811 
912 
l~787 l~888 
913 
l~789 
914 
079D 
9/5 
87R5 
916 
B7RB 
917 
0785 
918 
t17DI 8D 
919 
92f.1 
921 
922 
923 
924 
925 
926 
927 
928 
929 


INX 
D 
INX 
H 
INR 
8 
JNZ 
FRI'1.13 
ENDFI'1T 
LHLD 
CLRSS 
LDR 
CHI 
RH 
* 
.",. TRRNSI'1IT TITLE 
LINE 
*XI'1TTL 
1'11/1 D,38 
LXI 
B,OPNDF 
XI'1TTL2 
1'101/ R,M 
STRX 
B 
INX 
H 
INX 
B 
CPI 
'80 
JEQ 
XI'1TTLE 
DCR 
0 
JNZ 
XI'1TTL 2 
XI'1TTLE 
JI'1P 
ENDFI'1T 
** TRRNSMIT 
COMMENTS 
LINE 
*XCLINE 
1'1~'I D ..52 
LXI 
B,LRBEL 
XCLI 
1'10\1 R,1'1 
STRX 
B 
INX 
H 
INX 
B 
CPI 
'8D 
JHI 
ENDFI'1T 
DCR 
0 
JNZ 
XCLI 


JI'1P 
ENDFI'1T 
*CHI 
CLRSS 
SKEL 
RTNFLG 
HSRI/E 
HEX 
LRBEL 
I'1NEI'1 
OPNDF 
CFLD 


'1''1''1' 


*'1'* 
'1''1''1' 


'1'*'1' 
DBL 
8 
RES 
20 
RES 
8 


RES 
6 
RES 
18 
RES 
28 
DRTR 
'8D 


'1'********'1''1'***'1'*'1''1''1''1''1''1'**'1'*'1'***'1'*'1'**'1''1'*'1'*** 
** SERRCH 
Z80 
OPCODE 
TRBLE 
FOR 
INSTRUCTION 
* OR 
PSEUDO-OP. 
ENTER 
WITH 
MNEI'10NIC IN H-L, 
* RND 
D-E. 
RHURN 
NITH 
INSTRUCTION 
CLRSS 
IN 
* L RND 
INSTRUCTION 
SKELETON 
IN H, 
CRRR~' OFF. 
* IF MNEI'10NIC NOT 
FOLWD 
CRRR~ 
RETURNS 
ON. 


***..,. 


IN 
THIS 
TRBLE 
THE 
HIGH 
BIT 
OF 
THE 
INSTRUCTION 
CLRSS 
WORD 
IS SET 
TO ONE 
IF 
THE 
INSTRUCTION 
DOES 
NOT 
REQUIRE 
RN 
OPERRND. 
THIS 
IS FOR 
THE 


938 
93/ 
932 
933 
87D2 
228E88 
934 
87D5 
EB 
935 
87D6 
221888 
936 
87D9 
(3I62l~ I 
937 
87DC 
2 I 1288 
938 
87DF 
I 18E88 
939 
87E2 
C5 
948 
87E3 
CDFE87 
941 
87E6 
CI 
942 l~7E7 B7 
943 
87E8 
CAF8fJ7 
944 
87EB 
23 
945 
87EC 
23 
946 
87ED 
OB 
947 
87EE 
78 
948 
117EF BI 
949 
87F8 
C2DFI17 
9511 87F3 
21FFFF 
951 
117F6 37 
952 
117F7 C9 
953 
87F8 
56 
954 
07F9 
23 
955 
87FA 
5E 
956 
87FB 
EB 
957 
87FC 
B7 
958 
87FD 
C9 
959 
968 
07FE 
8684 
961 8888 8E88 
962 
8882 
IA 
963 
8883 
96 
964 
11884 BI 
965 
8885 
4F 
966 
11811613 
967 
8887 
23 
968 
8888 
85 
969 
8889 
C28288 
978 
B88C 
79 
971 
888D 
C9 
972 
888E 
973 
974 
975 
976 
977 
8812 
CFD2C7R8 
978 
8816 
8888 
979 
8818 
C5CEC4R8 
988 
881C 
8188 
981 
88/E 
CID2D3R8 
982 
8822 
828B 
983 
8824 
D4C9D4CC 
984 
8828 
8388 
985 
882A 
D5CECCR8 
986 
882E 
8488 
987 
8838 
CCD3D4R8 


.'/< USE 
OF 
THE FOR/'/RTROUTINE. 


.'/< 


.'/< 
OPSRC 
SHLD 
OP 


XCHG 
SHLD 
LXI 
LXI 
OPSRCI 
LXI 
PUSH 
CALL 
POP 
ORA 
JZ 
INX 
INX 
DCX 
/'I0V 
ORR 
JNZ 
LXI 
STC 
RET 
EUREKR 
/'IOV 
INX 
MOV 
XCHG 
RSC 
RET 


.'/< CO/,/PARE4 CHRR 
/'INE/'IONIC 
OPC/,/PR /,/VI 
B,4 
/'1111 
C,fJ 
OPC/,/P1 
LDAX 
D 
SUB 
/'/ 
ORA 
C 
/'/011 
c,A 
INX 
D 
INX 
H 
DCR 
B 
JNZ 
OPC/,/PI 
/'/011 A,C 
RET 
RES 
4 
EQU 
354 


OP+-2 
B,TSIZE 
H, ITBL 
D..OP 
B 
OPC/,/PR 
8 
R 
EUREKA 
H 
H 
8 
A,8 
C 
OPSRCI 
H,-I 


D,/'/ 
H 
E,/'/ 


OP 
TSIZE 
.'/< 


.'/< CLASS 
8 - 


.'/< 
ITBL 
ASC 
D8L 
ASC 
DBL 
RSC 
DBL 
ASC 
DBL 
ASC 
D8L 
fiSC 


'ORG 
' 


8 
'END 
' 
:8881 
'ARS 
' 


:88ff2 
'TITL 
' 


3 
'UNL 
' 
:8884 
'LST 
' 


988 8834 8588 
989 8836 
C4CID4CI 
998 883R 8688 
991 883C 
C5DID5R8 
992 8848 8788 
993 
8842 
CID3C3R8 
994 8846 8888 
995 8848 D2C5D3R8 
996 884C 8988 
997 884E 
C2D3D3R8 
998 8852 898B 
999 8854 D2C5CDR8 
888 8858 8R88 
881 885R 
C4C2CCR8 
t182885E 
8B88 
883 
B84 
885 
886 
887 
888 
889 
818 8868 CIC4C4RB 
BII 
8864 
8881 
BI2 8866 
CIC4C3R8 
813 886R 
8881 
814 886C D3D5C2R8 
815 887B 
9881 
816 8872 D3C2C2R8 
817 
8876 
9881 
818 8878 C9CED2R8 
819 887C 
84BI 
B28 887E 
C4C3D2A8 
821 8882 8581 
822 8884 CICECIR8 
823 tl888 
R80 I 
B24 088A D8D2CIR8 
825 888E R881 
B26 tl898 CFD2C IAO 
827 tlB94 BB81 
828 8896 C3CDD8RB 
829 889R 
8881 
830 
831 
832 
833 
889C 
CDCFD6R8 
834 t18A8 4882 
835 
836 
837 
838 88A2 
CDD6C9A8 
839 88R6 
8683 
t148 
841 
042 
843 88A8 
CCC4CIRB 
844 88AC 
3A04 
845 88AE 
D3D4CIA8 


DBL 
'8885 
AsC 
'DATA' 


DBL 
6 
RsC 
'EQU' 


DBL 
7 


AsC 
'AsC' 


DBL 
8 
RsC 
'RES" 


DBL 
9 
AsC 
'Bss' 


DBL 
9 
AsC 
'REM' 


DBL 
'888R 
AsC 
'DBL' 
DBL 
II 
*'"HOW ABOUT 
RDDING 
TPL 
QURD AND FPC PSEUDO 
OPS 
'"FOR 
TRIPLE, 
QUADRUPLE 
RND FLOATING 
POINT 
'"CONS TRN Ts . 
*'"CLRss 
I - SINGLE 
REGISTER 


'" 
AsC 
'ADD' 


DBL 
'188 
RsC 
'RDC' 


DBL 
'188 
RsC 
'SUB' 


DBL 
'198 
AsC 
'sBB' 
DBL 
'198 
AsC 
'INR' 


DBL 
'184 
ASC 
'DCR' 


DBL 
'185 
RsC 
"ANR' 


DBL 
'IR8 
ASC 
'XRR' 


DBL 
'IR8 
ASC 
'ORA' 


D8L 
'188 
ASC 
'CHP' 


DBL 
'188 
*'"CLASS 2 - 2 SINGLE 
REGISTERS 


'" 
RsC 
'/'IOV' 


DBL 
'248 
** CLASS 3 - SINGLE 
REG. 
+ DRTA 
WORD 
* 
RSC 
'/'lVI' 


DBL 
'386 
** CLASS 4 - 16 8IT OPERRND 
* 
RSC 
'LDR' 


DBL 
'43R 
RSC 
'STR' 


846 88B2 
3284 
847 88B4 CCC8CCC4 
848 88B8 2R84 
849 88BR 
D3C8CCC4 
858 88BE 2284 
851 88C8 
CRCDD8R8 
852 88C4 
C384 
853 88C6 
CRDRR8R8 
854 88CR 
CR84 
855 88CC 
CRC5DIR8 
856 
88Dtl CR84 
857 88D2 CRCEDRR8 
t158 
88D6 C284 
859 88D8 
CRCEC5R8 
868 88DC 
C284 
861 88DE 
CRC3R8R8 
862 fJ8E2 DR84 
863 88E4 
CRCICCR8 
864 88E8 DR84 
865 88ER 
CRCCD3R8 
ll66 88EE DR84 
867 88F8 
CRCEC3R8 
868 88F4 D284 
869 88F6 
CRC7C5R8 
878 88FR 
D284 
871 88FC 
CRD8CFRfJ 
872 
ll98fJE2fJ4 
873 
8982 
CRCED6R8 
ll74 t1986 E284 
875 
8988 
CRD8C5R8 
ll76 898C ER84 
(H7 898E 
CRD6R8R8 
878 8912 ER84 
879 8914 CAD8R8R8 
(188 8918 F284 
881 891A 
CACDR8R8 
882 891E FR84 
883 
8928 
CABEBDR8 
884 
8924 
F284 
885 
8926 
CRBCR8R8 
886 892R FR84 
887 892C 
C3CICCCC 
888 
8938 
CD84 
889 
8932 
C3CEDRR8 
898 
ll936 C484 
891 8938 
C3CEC5R8 
092 893C C484 
893 093E 
C3DRR8RfJ 
894 
8942 
CC84 
fJ95 8944 
CJC5R8R8 
096 8948 
CCt14 
097 894A 
C3CEC3R8 
898 894E D4t14 
899 
8958 
C3CCD3R8 
188 8954 
D4t14 
181 0956 
C3C3R8R8 
It12 895R DC84 
183 895C 
C3C7C5R8 


DBL 
'432 
ASC 
'LHLD' 


DBL 
'42A 
RSC 
'SHLD' 


DBL 
'422 
ASC 
'JMP' 


DBL 
'4C3 
RSC 
'JZ 
DBL 
'4CR 
RSC 
·'JEQ' 


DBL 
'4CR 
RSC 
"JNZ" 


DBL 
'4C2 
ASC 
'JNE' 


DBL 
'4C2 
ASC 
'JC 
DBL 
'4DR 
ASC 
'JRL' 


DBL 
'4DA 
RSC 
'JLS 
' 


DBL 
'4DR 
ASC 
'JNC' 
DBL 
'4D2 
RSC 
'JGE 
' 


DBL 
'4D2 
ASC 
'JPO 
' 


P8L 
'4E2 
ASC 
'JNV' 


DBL 
'4E2 
ASC 
'JPE' 


D8L 
'4EA 
ASC 
'JV 
PBL 
'4ER 
ASC 
'JP 
OBL 
'4F2 
ASC 
'J/'1 
DBL 
'4FR 
ASC 
'J)=' 


DBL 
'4F2 
RSC 
.'J<: 
DBL 
'4FR 
RSC 
'CALL·' 


DBL 
'4CD 
RSC 
'CNZ' 


DBL 
'4C4 
RSC 
'CNE' 


DBL 
'4C4 
RSC 
'CZ 
DBL 
'4CC 
ASC 
'CE 
DBL 
'4CC 
RSC 
'CNC' 


DBL 
'4D4 
ASC 
'CLS' 


DBL 
'4D4 
ASC 
'CC 
DBL 
'4DC 
ASC 
'CGE' 


104 t1960 
DC04 
185 8962 
C3D0CFR0 
/{;16 0966 
£484 
187 0968 
C3C£06RO 
188 096C 
£4t14 
109 096£ 
C300C5A0 
IItl 
t1972 
EC04 
1/10974 
C3D6RORO 
I12 0978 
ECt14 
113 897A 
C3DOR0RO 
I14 t197E 
F404 
115 0988 
C3BEBDR8 
116 0984 
F484 
117 0986 
C3CDRORO 
118 098A 
FCt14 
119 098C 
C38CROAO 
120 1.~998 FCt14 
121 
122 
123 
124 8992 
CCD8C9A8 
125 0996 
0/05 
126 
127 
128 
/29 0998 CCC4CID8 
138 099C 
OA06 
13/ 099E 
D3D4CID8 
132 t19R2 
0286 
/33 09A4 
C9CED8A8 
134 89R8 
03t16 
135 09AA 
C4C3D8A8 
136 t19AE 0806 
137 0980 
C4CIC4R0 
138 0984 
1.~986 
139 8986 
DOD5D3C8 
140 09BA 
C506 
141 898C 
DOD3C8RO 
142 t19C8 
C506 
143 89C2 
DOCFD8RO 
144 09C6 
C186 
/45 
146 
147 
148 09C8 
D8C3C8C7 
149 89CC 
EB87 
150 09C£ 
C4CICIA8 
151 09D2 
2787 
152 0904 
D2CCC3A0 
/53 1.~9D88787 
154 89DA 
D2D2C3A8 
155 890E 
OF87 
156 89E8 
D2CICCA8 
157 89£4 
1787 
158 89E6 
D2CID2R8 
159 09EA 
IF87 


/60 89EC 
C3CDCIA8 
/6/ 89FO 2F87 


DBL 
'4DC 
RSC 
'CPO' 
DBL 
'4E4 
ASC 
'CNV' 


D8L 
'4E4 
RSC 
'CPE' 
DBL 
:4EC 
RSC 
'CV 
DBL 
'4EC 
RSC 
'CP 
DBL 
'4F4 
RSC 
'C}=' 


PBL 
'4F4 
RSC 
-'CM 
DBL 
'4FC 
RSC 
'C( 


D8L 
'4FC 
** CLASS 
5 - REG_ 
PAIR 
+ /6 BIT 
OPERAND 
* 


** CLRSS 6 - REGISTER 
PRIR 
* 
RSC 
DBL 
RSC 
DBL 
RSC 
D8L 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
D8L 
RSC 
DBL 


'LDRX' 
'6tlA 
'STRX' 
'682 
'INX 
' 
'6tH 
'ocx ' 
'688 
'DRD 
' 


'609 
'PUSH' 
'6C5 
'PSH 
' 


'6C5 
'POP 
-' 
'6CI 
** CLASS 
7 - NO OPERRND 
* 
RSC 
'XCHG' 
DBL 
'87£B 
RSC 
'-DAR' 


DBL 
'8727 
ASC 
'RLC' 


DBL 
'8787 
ASC 
'RRC 
/ 


DBL 
'870F 
ASC 
'RAL 
--- 
DBL 
'8717 
ASC 
'RAR' 


DBL 
'871F 
ASC 
'Cf1A-' 
DBL 
'872F 


162 09F2 CJCDC3RO 
163 89F6 3F87 
164 fl9F8 
DJD4C3R13 
165 09FC 3787 
/66 89FE D2DJC3RO 
167 BR82 8787 
168 8R84 DRCID2RO 
169 8R98 AF87 
/7B BRBR D2C5D4RB 
171 OR8E C987 
172 8R /l~ L>2CEDRRO 
173 8AI4 C087 
174 8RI6 D2CEC5RO 
175 8RIR C087 
176 8AIC D2DRRBR8 
177 BR29 C887 
178 8R22 D2C5DIR8 
179 9A26 C887 
188 BR28 D2CEC3R8 
181 aR2C D887 
182 8R2E D2C7C5RB 
183 (~R32 Da87 
184 8RJ4 D2C3R8RB 
185 8R38 D887 
186 8R3A D2CCD3RB 
187 8R3E D887 
/88 8R4a D2D8CFR8 
189 8R44 E887 
198 8R46 D2CED6RB 
/9/ 8R4R E887 
/92 tlR4C D2DtlC5R8 
/93 
aRS8 E887 
/94 8R52 D2D6RBR8 
/95 aR56 E887 
/96 BRS8 D2D8R8R8 
197 8RSC F887 
/98 8RSE D28E8DR8 
/99 8R62 F087 
288 8R64 D2CDR8R8 
281 8R68 F887 
282 8R6R D28CR8R8 
283 8R6E F887 
284 8R7e D8C3C8CC 
285 8R74 E987 
286 eR76 D8D4C8CC 
287 8R7R E387 
288 8R7C D3D13C8CC 
289 eA80 F987 
2113 8R82 C5C9R8R8 
21 I I3R86 FB87 
212 8R88 C4C9R8R8 
213 8R8C F387 
214 8R8E C8CCD4RB 
215 8M2 
7687 
216 
tlR94 
CECFD8R8 
217 8R98 8887 
218 8R9R RRRRRRR8 
219 fJR9E 8887 


RSC 
'C/'IC' 


DBL 
'873F 
RSC 
'STC " 


D8L 
'8737 
RSC 
'RSC " 


D8L 
'8787 
RSC 
'ZRR' 


D8L 
'87RF 
RSC 
'RET' 


DBL 
'87C9. 
RSC 
/RNZ 
/ 


DBL 
'87GB 
RSC 
'RNE " 


D8L 
'87C8 
RSC 
'RZ 
DBL 
'87C8 
RSC 
'Rm 
" 


DBL 
'87C8 
RSC 
'RNC' 


D8L 
'87D8 
RSC 
'RGE' 


D8L 
'87D8 
RSC 
'RC 
' 


D8L 
'87D8 
RSC 
'RLS " 


D8L 
'87D8 
RSC 
'RPO' 


DBL 
'87E8 
RSC 
'RNV' 


D8L 
'87E8 
RSC 
'RPE " 


D8L 
'87E8 
RSC 
'RV 
D8L 
'87£8 
ASC 
'RP 
DBL 
'87F8 
RSC 
'R)=' 
D8L 
'87F8 
RSC 
'R/'I 
D8L 
'87F8 
RSC 
'R( 


DBL 
'87F8 
RSC 
'PCHL' 


D8L 
'87E9 
RSC 
'XTHL" 


DBL 
'87E3 
RSC 
'SPHL " 


DBL 
'87F9 
RSC 
'El 
D8L 
'87FB 
RSC 
'Dl 
DBL 
'87F3 
RSC 
'HLT' 


DBL 
'8776 
RSC 
'NOP' 
D8L 
'878e 
RSC 
'***' 
D8L 
'8798 


PAGE 
22 
Z80 
RESIDENT 
EDITOR/AssEt'18LER 


22tl 
-* 
221 
-* CLASS 
8 - ONE 
DATA 
UORD 
222 
-* 
223 
BAAB 
C/C4C9RO 
AsC 
'RDI , 


224 
OAA4 
C688 
D8L 
'8C6 
225 
8AR6 
C/C3C9RO 
RsC 
'RCI , 


226 
OARR 
CEB8 
D8L 
'8CE 
227 8AAC 
D3D5C9RO 
AsC 
'SUI , 


228 
OR8tl D608 
D8L 
'8D6 
229 OA82 
D3C2C9R('t 
AsC 
'581 , 


23tl 
l~A86 DE08 
D8L 
'SDE 
23/ 
ORBS 
C/CEC9AO 
RsC 
'RNI , 


232 
OABC 
E6tlS 
DBL 
'SE6 
233 
8ABE 
DSD2C9RO 
AsC 
'XRI , 


234 
OAC2 
EEOS 
D8L 
'SEE 
235 
8AC4 
CFD2C9AO 
AsC 
'ORI , 


236 
tlACS F68S 
D8L 
'SF6 
231 
BACA 
C3DOC9AO 
ASC 
'CPI 
.- 


238 
ORCE 
FEOS 
D8L 
'8FE 
239 
BADO 
C9CEAOAO 
ASC 
'IN 
24tl tlAD4 D88S 
D8L 
'SD8 
241 
BAD6 
CFD5D4A13 
ASC 
'OUT , 


242 
fJADA D30S 
D8L 
:8D3 
243 
-* 
244 
-* CLASS 
9 - !NO UORD 
PSEUDO 
OP 
245 
-* 
246 
8ADC 
D4C3C1 Atl 
ASC 
'TCA , 


247 
OREO 
13/89 
D8L 
'S901 
24S 
tlAE2 D3D4CFDO 
ASC 
'STOP'- 


249 
BRE6 
8289 
D8L 
'89B2 
258 
tlAES D7C IC9D4 
ASC 
'WAIT' 


251 
OREC 
0289 
D8L 
'S982 
252 
-* 
253 
-* CLASS 
A - OPERANL) 0-7 
254 
'* 
255 
OAEE 
D2D3D4AB 
ASC 
'RST , 


256 
l~AF2 C7BA 
D8L 
'AC7 
257 
BAF4 
D4D2DOAO 
ASC 
'TRP , 


258 
tlAFS C7fJA 
D8L 
'RC7 
259 
-* 
260 
-* Z88 
INSTRUCTION 
H'PES 
261 
* 
262 
-* CLASS 
8 - 2 8YTES 
FIXED 
+ DISPLACEt'1ENT 
263 
aAFR 
CCCIDSAO 
ASC 
'LAX , 


264 
ORFE 
7E08 
DBL 
'87E 
265 
OBal~ CCC2DSAtl 
ASC 
'L8X , 


266 
t1804 460B 
DBL 
'846 
267 13886 CCC3DSAO 
RSC 
'LCX , 


268 
08tlR 4EgB 
DBL 
'B4E 
269 
a80C 
CCC4DSAO 
ASC 
'LDX , 


27tl 
a8/l~ 56gB 
DBL 
'B56 
271 
8812 
CCC5D8RO 
RSC 
'LEX , 


2'12 
OBI6 
5E88 
DBL 
'B5E 
273 
OBI8 
CCCSD8R8 
RSC 
'LHX , 


274 
881C 
6688 
D8L 
'866 
275 881 E CCCCDSAl~ 
RSC 
'LLX , 


276 
8822 
6E08 
D8L 
'B6E 
277 
0824 
D3CID8RO 
RSC 
'SAX , 


369 


PRGE 
23 
28ft 
RESIDENT 
EDITOR/RssEM8LER 


278 
8B28 
7?8B 
DBL 
:877 
279 8B2A 
D3C2D8R8 
RsC 
'sBX , 


28tl 
OB2E 
78l'lB 
D8L 
'B78 
28/ 
8838 
D3C3D8R8 
AsC 
'scx , 


282 
8834 
7/8B 
DBL 
'B7/ 
283 
8836 
D3C4D8R8 
AsC 
'sDX 
-' 


284 
tlB3R 
72fJB 
DBL 
'B72 
285 
883C 
D3C5D8R13 
RsC 
'SEX , 


286 
884ti 730B 
DBL 
'B73 
287 
8842 
D3C8D8R13 
RsC 
'sHX , 


288 
l'IB46 748B 
DBL 
'B74 
289 
8848 
D3CCD8Rl'I 
RsC 
'SLX 


/ 


29l'18B4C 
75tlB 
DBL 
'875 
291 
884E 
CCCID9RO 
RsC 
'LRY , 


292 
OB52 
7El'lB 
DBL 
'B7E 
293 
8854 
CCC2D9RO 
AsC 
-'LBY , 


294 
tiB58 4688 
D8L 
'846 


295 
885A 
CCC3D9R8 
RSC 
"LC'T' 
296 
OB5E 
4EOB 
DBL 
'B4E 
297 
8868 
CCC4D9AO 
RSC 
-'LD'r', 


298 OB64 
56l'1B 
DBL 
'B56 


299 
13866 CCC5D9RO 
ASC 
'LE'r', 


3l'10tlB6A 5EtlB 
DBL 
'B5E 
38/ 
8B6C 
CCC8D9RO 
AsC 
'~LH'T' 


302 
OB70 
6-6l'1B 
DBL 
'B66 
3133 8872 
CCCCD9RO 
AsC 
-'LL'r' 
3tl4 OB76 
6El'lB 
L>BL 
'B6£ 
3l'l5l:t878 
D3C/D9AO 
AsC 
-'SAY , 


3ti6 OB7C 
7708 
DBL 
:877 
387 
OB7E 
D3C2D9AO 
AsC 
-'sB'r' 


/ 


308 
l'lB827tltlB 
DBL 
B?O 
309 
8B84 
D3C3D9AO 
AsC 
'SC'r' 
3/l'It1B88 
7/0B 
OBL 
'B7/ 


3/1 
OS8A 
D3C4D9A8 
ASC 
'SDY , 


3/2 
OB8E 
7208 
L>BL 
:872 
313 
OB9l'lD3C5D9AO 
ASC 
-'sE'r' 


3/4 
tiB94 73tiB 
DBL 
:873 
3/5 
l'lB96L>3C8D9RO 
AsC 
/SH't' 


3/6 
tiB9A 74tiB 
DBL 
'B74 
3/7 
8B9C 
D3CCD9Rtl 
AsC 
"SL'T' 
318 
OBAO 
75l'1B 
DBL 
'B75 
3/9 
8BR2 
C/C4C4D8 
ASC 
'"RDDX' 


32l'1OBA6 
86gB 
DBL 
:886 
32/ 
OBRS 
C/C4C3D8 
ASC 
'ADC,· .. 


322 
tiBAC 8EOB 
DSL 
'B8£ 


323 
I3BAE D3D5C2D8 
ASC 
'sUBX' 


324 
gBB2 
9688 
DBL 
'B96- 


325 
8BB4 
D3C2C3D8 
AsC 
'SBC.'x,·' 


326 
tiBB8 9ftiB 
DBL 
B9E 
::?'~7BBBA 
C/CED8A8 
ASC 
-'ANX 
~,. 
328 l'lBBER60B 
L>BL 
'BA6 
329 
I3BCO CFD2D8R(~ 
ASC 
-'ORX 


/ 


330 
OBC4 
86JJB 
D8L 
'8B6 
33/ 
8BC6 
DSD2DSAO 
ASC 
'-XRX , 


332 
gBCA 
AEI3B 
DBL 
'BAE 
333 
88CC 
C3CDDOD8 
ASC 
'"CNPX-' 


334 
IJBDO BEOS 
DBL 
'BSE 


335 
8BD2 
C9CECDD8 
ASC 
---INNX-' 


370 


336 
08D6 
34&B 
DBL 
'B34 
337 
I3B08 C4C3C008 
RSC 
'DC/'IX' 
338 
l'BDC 350B 
DBL 
'B35 
339 
8BOE 
CIC4C409 
RSC 
"'ADD'r'/, 


34l' l'BE2 860B 
DBL 
'B86 
341 
138E4 CIC4C309 
RSC 
'RDC~" 
342 
l'BE8 8E08 
DBL 
'B8E 
343 
OBER 
D3D5C2D9 
RSC 
'SUBY" 


344 
l'BEE 960B 
DBL 
'B96 
345 
138FO D3C2CJ09 
RSC 
"SBC~" 


346 
OBF4 
9EtlB 
DBL 
'B9E 
347 
OBF6 
CICED9Al' 
RSC 
'AN~' 
348 
l'BFR AGOB 
DBL 
'BR6 
349 
I3BFC CFD2D9RO 
ASC 
'OR~' , 


350 
OCOO 
B60B 
DBL 
'BB6 
351 
(.jCt~2D8D209RO 
RSC 
"XR~' 
352 
OC06 
An'B 
DBL 
'BAE 
353 
l~C138C3COD009 
RSC 
'CNP~" 
354 
OCOC 
BEtlB 
DBL 
··BBE 
355 
OCOE 
C9CEC009 
ASC 
'INrw·' 


356 
OCI2 
340B 
DBL 
'834 
357 
I3C/4 C4C3CC>D9 
ASC 
"DCN~'" 


358 OCI8 
35tlB 
DBL 
'835 
359 
'" 
360 
'" 
CLRSS 
C - 2 B~'TES FIXED.- 
DISPLRCENENT.- 
INN. 
OP. 


361 
'" 
362 
OCIR 
D3C9D8RO 
RSC 
··-SIX 
STORE 
INNEDIRTE 
THFWUGH 
X 


363 
8CIE 
36tlC 
DBL 
'C36 
364 
OC2@ 
D3C9D9RO 
RSC 
"SH' 
STORE 
INNEC>IRTE 
THROUGH 
~' 
365 
13C24 3613C 
DBL 
'C36 
366 
'" 
367 
'" 
CLRSS 
D - 
BYTE 
FIXED 
368 
'" 
369 OC26 
D8CIC6RO 
RSC 
'XRF , 
EXCHRNGE 
A ..F WITH 
W ..F'" 


37ft 
OC2A 
(188D 
DBL 
'8D08 
371 
l~C2C C5D8D8AO 
RSC 
'EXX , 
EXCHANGE 
B-L 
WITH 
B~'-L ' 


??~ 
OC3l' D98D 
D8L 
'8DD9 
~,~ 
373 
'" 
374 
'" 
CLASS 
E - 
B~'TE - SkELETON 
+ R.P. 


375 
'" 
376 
OC32 
C4CIC3AO 
ASC 
'"DRC , 
DOUBLE 
RDD 
WITH 
CRRR~' 
TO Hc~L 
377 
l~C36 13AtlE 
DBL 
'Et~A 
378 OC38 
C4D3C3RO 
RSC 
'DSC 
DOUBLE 
SUB TRRC T I4ITH CRf,'R~'F 
379 13C3C 132tlE 
DBL 
'E1.'I2 
380 
'" 
381 
'" 
CLASS 
F - 2 BYTES 
FI,\'ED + 
16 BIT 
OPEF:RNf> 
382 
."t. 
383 
'" 
NULL 
SET. 
FED 
B'r' 
808l~ CLRSS 
C"~. 
384 
'" 
385 
'" 
3'86 
'" 
CLRSS 
10 - 2 B~'TES FIXEf> 
+ 
/6 
BIT 
OPERAND 
387 
'" 
388 tlC3E CCC2C3C4 
RSC 
'LBCD" 
LOAf> B-C 
DIRECT 
389 
13C42 4BIO 
DBL 
'1134B 
390 
l'C44 CCC4C5C4 
RSC 
"LDED""" 
LORD 
[)-E DIRECT 
391 
13C48 5810 
DBL 
'Itl5B 
392 
OC4R 
CCD3f>OC4 
RSC 
"LSPD' 
LOAD 
STRCK 
POINTER 
C>IRECT 
393 l~C4E 781(l 
DBL 
'11378 


371 


394 
OC50 
D3C2C3C4 
395 
OC54 
43/0 
396 
OC56 
D3C4C5C4 
397 
OC5A 
53/0 
398 
OC5C 
D3D3VOC4 
399 
OC5t1 73 I0 
400 
OC62 
CCD8C4AO 
401 
OC56 
2Ala 
402 
OC68 
D3DSC4AO 
403 
t1C6C 22 I(1 


404 
OC6E 
CCD9C4AO 
405 
OC72 
2AIO 
406 
OC74 
D3D9C4AO 
407 
8C7S 
22/0 
408 
489 
4 I t1 
411 
412 
4/3 
414 
4/5 
416 
OC7A 
D4CIC9AO 
4/7 
OC7E 
5792 
4/S 
OCSO 
D4C/D2AO 
4/9 
8C84 
5F92 
420 
OC86 
D4C9C/AO 
42/ 
OC8A 
4792 
422 
OCSC 
D4D2C/AO 
423 
8C90 
4F92 
424 
OC92 
D2C5D4C9 
425 
8C96 
4D92 
426 
OC98 
D2C5D4CE 
427 
8C9C 
4592 
428 
OC9E 
C9CEABAO 
429 
OCA2 
R292 
430 
OCA4 
C9CEABD2 
43/ 
l'lCR88R92 
432 
OCAR 
C9CEADAO 
433 
OCRE 
RR92 
434 
OCBO 
C9CERDD2 
435 
t1C84 8R92 
436 
OCB6 
CFD5D4R8 
437 
OC8A 
R392 
438 
OCBC 
CFD4RBD2 
439 
occe 
8392 
440 
OCC2 
CFD5D4RD 
44/ 
OCC6 
RB92 
442 
OCC8 
CFD4ADD2 
443 
eccc 
BB92 
444 
OCCE 
C9CEC/AO 
445 
OCD2 
7892 
446 
OCD4 
C9CEC2AO 
447 
eCD8 
4092 
448 
OCDA 
C9CEC3AO 
449 
OCDE 
4892 
450 
OCEO 
C9CEC4RO 
45/ 
eCE4 
5092 


RSC 
'SBClV 
STOI<'EB-C 
DIRECT 
DBL 
'/04,:' 
ASC 
'SDED' 
STORE 
D-E 
DIRECT 
DBL 
'1053 


ASC 
/SSPV 
STOf.'ESTRCK 
POINTER 
MRECT 
DBL 
' /1373 


AC;I~ 
'LXV 
" 
LOAD 
X DIRECT 
DBL 
'I02A 
ASC 
"SXV 


/ 
STORE 
X DIRECT 
DBL 
: 1022 
AC;I~ 
"L~'D 


,.' 
LOR[J ~' DIRECT 
[JBL 
'I02A 
RSC 
'''S~'D 


", 
STORE 
~' DIRECT 
DBL 
'/022 
** CLASS 
II 
- 2 B'r'TESFIXED 
NITH 
X 01<''T' OPERAND 
** NULL 
SET 
FED 
B~' S080 
CLRSS 
6 
*** CLASS 
12 - 2 B~'TES FIXED ..ED 
PREFIX 


* 
RSC 
/TAI 


", 


DBL 
:9257 
ASC 
"TRR 
" 


DBL 
'925F 
ASC 
/TIA 
/ 


D8L 
'9247 
ASC 
"'TRA 


", 


DBL 
'924F 
ASC 
/RETI' 


D8L 
'924D 
ASC 
'RETW 
DBL 
'9245 
ASC 
"IN+ 


/ 


D8L 
:92A2 
ASC 
"IN+R'" 


DBL 
'92BA 
ASC 
"IN- 
" 


DBL 
'92RA 
ASC 
"IN-R" 


DBL 
'92BA 
RSC 
"OUT+" 


D8L 
'92WS 
ASC 
"OT+R'" 
DBL 
:928::3 
RSC 
"'OUT-'" 


D8L 
'92RB 
ASC 
"OT-R/ 


DBL 
'92BB 
RSC 
"'INR " 


DBL 
:9278 
RSC 
'INB 
" 
D8L 
'9240 
RSC 
"INC 
/ 


D8L 
:9248 
RSC 
/IND 
/ 


D8L 
'9250 


452 8CE6 C9CEC5R8 
453 aCER 5892 
454 8CEC C9CEC8R8 
455 aCFa 6892 
456 BCF2 C9CECCR8 
457 aCF6 6892 
458 8CF8 CF04C/RO 
459 0CFC 7992 
460 8CFE CF04C2R8 
46/ 8082 4/92 
462 8004 CF04C3Ra 
463 8088 4992 
464 008R CF04C4R8 
465 8D8E 5192 
466 80/8 CF04C5RO 
467 80/4 5992 
468 80/6 CF04C8R8 
469 80lR 6192 
478 8DIC CF04CCR8 
471 8020 6992 
472 8D22 CDD7RBR8 
473 8026 R892 
474 8028 C007R802 
475 802C B892 
476 8D2E C007RDM 
477 8032 R892 
478 8D34 CD07ROD2 
479 8D38 8892 
488 803R C3D8R8R8 
48/ 8D3E RI92 
482 8D48 C3Dl'IRB02 
483 8044 8/92 
484 8046 C3D8RDR8 
485 8D4R R992 
486 8D4C C308R002 
487 8D58 8992 
488 8D52 CEC5C7R8 
489 8D56 4492 
498 8058 C9C088RB 
491 BD5C 4692 
492 8D5E C9CD8/RB 
493 8D62 5692 
494 8064 C9COB2R8 
495 BD68 5E92 
496 806R 02CCC4R8 
497 8D6E 6F92 
498 8D78 D2D2C4R8 
499 8D74 6792 
588 
581 
582 
503 8D76 D2D2C3C2 
584 BD7R 0893 
585 8D7C D202C3C3 
586 OD80 0993 
587 8D82 D2D2C3C4 
588 8086 fJR93 
589 8D88 0202C3C5 


RSC 
'INE " 


D8L 
'9258 
RSC 
'INH' 


D8L 
'9260 
RSC 
'INL' 


D8L 
'9268 
RSC 
"OTR' 


D8L 
'9279 
RSC 
'OTB' 


DBL 
'924/ 
RSC 
'OTC' 


D8L 
'9249 
RSC 
'OTD' 
D8L 
'925/ 
RSC 
'OTE' 


DBL 
'9259 
RSC 
'OTH' 


D8L 
'926/ 
RSC 
'OTL' 


D8L 
'9269 
RSC 
'/'114+' 


D8L 
'92R0 
RSC 
'/'If,I+R' 


DBL 
'92B8 
RSC 
'/'114-' 
DBL 
'92R8 
RSC 
'fff,l-R' 


D8L 
'92B8 
RSC 
'CP+' 


DBL 
'92R/ 
RSC 
'CP+R' 


D8L 
'92BI 
RSC 
"CP-' 


DBL 
'92R9 
RSC 
'CP-R' 


DBL 
'92B9 
RSC 
'NEG' 


DBL 
'9244 
RSC 
'1/'18' 


DBL 
'9246 
RSC 
"Iffl' 
DBL 
'9256 
RSC 
'I/12' 


DBL 
'925E 
RSC 
'RLD' 


DBL 
'926F 
RSC 
'RRD' 


DBL 
'9267 
'"'"CLRSS 13 - 2 BVTES FIXED, CB PREFIX 
'" 
RSC 
'RRC8' 


D8L 
'9308 
RSC 
'RRCC' 


DBL 
'9309 
RSC 
'RRCO' 


D8L 
'930R 
RSC 
'RRCE' 


518 
9D8C 9893 
5 II 0D8£ D2D2C3C8 
512 
8D92 9C93 
513 
8D94 D2D2C3CC 
514 
8D98 8D93 
5/5 
8D9R D2D2C3CD 
5/6 
8D9£ 8£93 
517 
8DR8 D2D2C3CI 
518 
9DR4 
9F93 
5/9 
8DR6 
D2C2D2R8 
528 
8DRR 
1893 
521 
8DRC 
D2C3D2R8 
522 
8D88 
1993 
523 
8082 
D2C4D2R8 
524 
8DB6 
IR93 
525 
8088 
D2C5D2R8 
526 
80BC 
IB93 
527 
80BE 
D2C8D2R8 
528 
80C2 
IC93 
529 
8DC4 
D2CCD2R8 
538 
8DC8 
1093 
531 
8DCR 
D2CD02R8 
532 
80CE 
IE93 
533 
80D8 
02CID2R4 
534 
8DD4 
IF93 
535 
8DD6 
CCCCC2R8 
536 
8DDR 
2893 
537 
8DOC 
CCCCC3R8 
538 
8DE8 
2193 
539 
8DE2 
CCCCC4R8 
548 
8DE6 
2293 
541 
8DE8 
CCCCC5R8 
542 
8DEC 
2393 
543 
8DEE 
CCCCC8R8 
544 
8DF2 
2493 
545 
8DF4 
CCCCCCR8 
546 
8DF8 
2593 
547 
8DFR 
CCCCCDR8 
548 
8DFE 
2693 
549 
8E88 
CCCCCIR8 
558 
8E84 
2793 
551 
8E86 
D2CCC3C2 
552 
8E8R 
8893 
553 
8E8C 
D2CCC3C3 
554 
8EI8 
8193 
555 
8£12 
D2CCC3C4 
556 
8EI6 
8293 
557 
8EI8 
D2CCC3C5 
558 
BEIC 
8393 
559 
8EIE 
D2CCC3C8 
568 
8E22 
8493 
561 
8E24 
D2CCC3CC 
562 
8E28 
8593 
563 
8E2R 
D2CCC3CD 
564 
8E2E 
8693 
565 
8E38 
02CCC3CI 
566 
8E34 
8793 
567 
8E36 
D2C2CCR8 


/D8L 
!Rsc 
,D8L 


I 
RSC 
08L 
RSC 
08L 
RSC 
08L 
RSC 
D8L 
R5C 
DBL 
RSC 
DBL 
RSC 
08L 
RSC 
D8L 
R5C 
DBL 
R5C 
DSL 
R5C 
DSL 
RSC 
DSL 
RSC 
DBL 
RSC 
DBL 
RSC 
DSL 
RSC 
DBL 
RSC 
DSL 
RSC 
D8L 
RSC 
D8L 
RSC 
D8L 
RSC 
DSL 
RSC 
DSL 
RSC 
D8L 
R5C 
D8L 
RSC 
DSL 
RSC 
D8L 
RSC 
D8L 
RSC 


:9388 
'RRCH' 
'938C 
'RRCL' 
'9380 
'RRC/'I' 
'938E 
'RRCR' 
'938F 
'RBR ' 
'9318 
'RCR 
' 


'9319 
'RDR 
' 
'931R 
'RER 
' 
'9318 
'RHR 
' 
'931C 
'RLR 
' 
:93/D 
'R/'IR 
' 
'931E 
'RRR$' 
'931F 
'LLB 
' 
'9328 
'LLC 
' 


'9321 
'LLD 
' 


'9322 
'LLE 
' 
'9323 
'LLH 
' 


'9324 
'LLL 
' 


'9325 
'LL,., , 
:9326 
'LLR 
' 
:9327 
'RLC8' 
:9388 
'RLCC' 
'9381 
'RLCD' 
'9382 
'RLCE' 
:9383 
'RLCH' 
:9384 
'RLCL' 
:9385 
'RLC,.,' 
:9386 
'RLCR' 
: 93f.17 
'RSL 
' 


568 
8E3R 
/893 
569 
OE3C 
D2C3CCR0 
570 
OE40 
I /93 
57/ 
OE42 'D2C4CCR0 
572 l~E46 /293 
573 
OE48 
D2C5CCR8 
574 
OE4C 
/393 
575 
0E4E 
D2C8CCR8 
576 
8E52 
/493 
577 
8E54 
D2CCCCRO 
578 
8E58 
/593 
579 
0E5R 
02CDCCR8 
580 
tlE5E /693 
58/ 
0E68 
D2C/CCR4 
582 
13E64 /793 
583 
OE66 
CID2C2R13 
584 
OE6R 
2893 
585 
8E6C 
C/D2C3R8 
586 
flE7f12993 
587 
8E72 
C/D2C4RO 
588 
flE76 2R93 
589 OE78 
C/D2C5R8 
598 
0E7C 
2B93 
59/ 
8E7E 
C/D2C8R0 
592 8£82 
2C93 
593 
0E84 
C/D2CCR0 
594 l~E882D93 
595 
8E8A 
C/D2CDR0 
596 
flE8E 2E93 
597 
8E90 
C/02C/R8 
598 
0E94 
2F93 
599 
OE96 
CCD2C2R8 
680 
0E9R 
3893 
68/ 
8E9C 
CCD2C3R8 
6fJ2 8ERfJ 3993 
603 
8ER2 
CCD2C4R8 
604 
0ER6 
3R93 
605 
0ER8 
CCD2C5RO 
606 
fJERC 3B93 
687 
8ERE 
CCD2C8R0 
688 
fJEB2 3C93 
609 
8E84 
CCD2CCRO 
6/8 
fJEB8 3093 
6// 
OEBR 
CCD2CDRO 
6/2 
fJEBE 3E93 
6/3 
8EC8 
CCD2C/R0 
6/4 
fJEC4 3F93 
6/5 
6/6 
6/7 
6/8 
OEC6 
C2D2C/RfJ 
6/9 
OECA 
/8/4 
628 
€JECC C2C3ROR0 
62/ 
8Eoa 
38/4 
622 
OED2 
C2CCD3RfJ 
623 
0ED6 
38/4 
624 
fJED8 C2CEC3Rtl 
625 
0EOC 
313/4 


DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 
RSC 
DBL 


:93/0 
'RCL 
' 
:93// 
'RDL 
' 
:93/2 
''REL 
' 
:93/3 
'RHL 
' 
:93/4 
'RLL 
' 
:93/5 
'RML 
' 
:93/6 
'RAL$' 
:93/7 
'ARB' 
:9328 
'RRC 
' 


:9329 
'RRD 
' 


:932R 
'RRE 
' 
:932B 
'RRH 
' 
:932C 
'RRL 
' 
:932D 
'RRM 
' 
:932E 
'RRA 
' 


:932F 
'LRB 
' 
:9338 
'LRC 
' 
:9339 
'LRD 
' 
:933R 
'LRE 
' 
:933B 
'LRH 
' 


:933C 
'LRL 
' 


:933D 
'LRM 
' 
:933E 
'LRA 
' 
:933F 


:/< 


:/< CLRSS 
/4 
- 
RELRT H'E BRRNCHES 


:/< 


RSC 
'BRR' 


DBL 
:/4/8 
RSC 
'BC 
DBL 
:/438 
RSC 
'8LS' 


DBL 
:/438 
RSC 
'BNC' 
DBL 
:/438 


626 8EDE 
C2C7C5R€I 
627 €lEE2 3€114 
628 8EE4 
C2DRR€lR8 
629 8EE8 2814 
638 
£lEER C2C5DIR8 
631 £IEEE 2814 
632 8EFO C2CEDRRO 
633 8EF4 
21.114 
634 fJEF6 C2CEC5R8 
635 8EFR 
2014 
636 8EFC 
C4C2CEDR 
637 0F88 
1014 
638 
639 
648 
641 
642 8FfJ2 C2D4C2RB 
643 0F86 
4815 
644 fJF88 C2D4C3RO 
645 0F8C 
4115 
646 8FOE C2D4C4RB 
647 8FI2 
4215 
648 BFI4 C2D4C5RB 
649 0FI8 
4315 
658 fJFIR C2D4C8Rtl 
651 8FIE 
4415 
652 8F28 
C2D4CCRI.1 
653 8F24 
45/5 
654 8F26 
C2D4CDR8 
655 0F2R 
4615 
656 8F2C C2D4CIR8 
657 8F30 
4715 
658 fJF32 C2D3C2RfJ 
659 0F36 
CBI5 
668 8F38 C2D3C3RB 
661 8F3C 
CI15 
662 8F3E C2D3C4R8 
663 8F42 
C215 
664 8F44 C2D3C5RI.1 
665 8F48 
C315 
666 
8F4R C2D3C8RB 
667 8F4E 
C315 
668 8F58 
C2D3CCRB 
669 0F54 
C515 
678 8F56 
C2D3CDR8 
671 OF5R 
C615 
672 1.1F5CC2D3C IR8 
673 OF61.1C? /5 
674 
8F62 C2C3C2R8 
675 0F66 
SOl5 
676 fJF68 C2C3C3R8 
67? 
0F6C 
8115 
6?8 OF6E 
C2C3C4R8 
679 0F72 
8215 
688 I:JF74C2C3C5R8 
681 8F78 
8315 
682 8F7R 
C2C3C8R8 
683 8F7E 8415 


RSC 
'8GE 
.. 
' 


D8L 
'1438 
RSC 
/8Z 
D8L 
'1428 
RSC 
'8EQ" 
DBL 
'/428 
RSC 
'BNZ " 


DBL 
'142€1 
RSC 
''BNE' 


D8L 
'1421.1 
RSC 
'D8NZ'" 


D8L 
'1410 


.'/< 


.'/< CLRSS 
15 - REGISTER 
BIT MRNIPULRTION 


.'/< PREFIX 
C8 


.'/< 
RSC 
''BT8 " 


DBL 
'1540 
RSC 
'8TC' 


DBL 
'/541 
RSC 
'BTD' 


DBL 
'/542 
RSC 
'8TE 
" 


DBL 
'/543 
RSC 
'BTH" 
D8L 
'1544 
RSC 
'BTL' 


DBL 
'1545 
RSC 
'BTM' 


DBL 
'/546 
RSC 
'8TA' 


D8L 
'1547 
RSC 
'858' 


D8L 
'/sea 
RSC 
'BSC' 


DBL 
'/5CI 
RSC 
'BSD 
" 


DBL 
'/5C2 
RSC 
'BSE' 


D8L 
'15C3 
RSC 
''BSH' 


DBL 
'/5C3 
RSC 
'BSL' 


D8L 
'15C5 
RSC 
'8SI'/' 


D8L 
'15C6 
RSC 
'BSR' 


D8L 
'/5C? 
RSC 
'8C8 
" 


DBL 
'1580 
RSC 
'BCC' 


DBL 
'1581 
RSC 
'8CD' 


DBL 
'/582 
RSC 
'BCE' 


DBL 
:1583 
RSC 
'BCH' 


DBL 
:1584 


684 
8F88 
C2C3CCR8 
685 
0F84 
8515 
686 
8F86 
C2C3CDR8 
687 
0F8R 
8615 
688 
8F8C 
C2C3CIR8 
689 
0F98 
8715 
698 
691 
692 
693 
0F92 
D2CCC3D8 
694 
8F96 
8616 
695 
0F98 
D2CCC3D9 
696 
8F9C 
8616 
697 
0F9E 
D2CDCCD8 
698 
l:.lFR21616 
699 
0FR4 
D2CDCCD9 
?tltl tlFR8 1616 
781 0FRA 
D2D2C3D8 
7t12 8FRE 
8E 16 
783 l:.lFB8D2D2C3D9 
784 tlFB4 fJEI6 
785 0FB6 
D2CDD2D8 


786 tlF8R IEI6 
787 0F8C 
D2CDD2D9 
7t18 
l~FC8 IE16 
789 0FC2 
CCCCCDD8 
7ltl tlFC6 
2616 
71/ 0FC8 
CCCCCDD9 
712 tlFCC 2616 
713 0FCE 
CID2CDD8 
714 8FD2 
2EI6 
715 0FD4 
CID2CDD9 
716 8FD8 
2EI6 
717 0FDA 
CCD2CDD8 
718 0FDE 
3EI6 
719 0FE0 
CCD2CDD9 
728 8FE4 
3EI6 
721 
722 
723 
724 8FE6 
C2D4CDD8 
725 0FER 
46/7 
726 8FEC 
C2D4CDD9 
727 0FF0 
46/ 7 


728 0FF2 
C2D3CDD8 
729 8FF6 
C617 
730 BFF8 
C2D3CDD9 
731 8FFC 
C6/7 
732 8FFE 
C2C3CDD8 
733 
1882 8617 
734 
1884 C2C3CDD9 
735 /088 8617 
736 
737 
738 
739 
740 
IBBR D8RBC2C3 
74 I 100E 8998 


RSC 
'BCL 
/ 


DBL 
'1585 
RSC 
''BC/'I' 


DBL 
'1586 
RSC 
''BCR ,. 
DBL 
'1587 


.oj.. 
* CLRSS 
16 - SHIFT/ROTATE 
/'IE/'IORY 
THROUGH 
X OR 
Y 
* 
RSC 
'RLCX'· 


DBL 
'1686 
ASC 
'RLC'r"· 


DBL 
'1686 
ASC 
'R/'ILX·' 


DBL 
'1616 
ASC 
'RNL'r'-' 


DBL 
'1616 
RSC 
'RRCX' 


DBL 
'168E 
RSC 
'RRCY' 


DBL 
:168E 
RSC 
'Rf1RX' 


DBL 
:161E 
ASC 
'Rf1RY' 


DBL 
'/61E 
RSC 
'LLf1X' 
DBL 
'1626 
RSC 
'LLNY·' 


DBL 
'1626 
RSC 
'RRf1X' 


DBL 
:162E 
RSC 
'RRf1Y' 


DBL 
'162E 
RSC 
'LRf1X' 


DBL 
'163E 
RSC 
'LRf1Y' 
DBL 
'163E 
** CLRSS 
I? BIT 
I'1RNIPULRTION THROUGH 
X OR 
'r' 
* 
RSC 
'BTI'1X 
, 


DBL 
:1746 
RSC 
'BrN'r"" 


DBL 
:1746 
RSC 
'BSI'1X' 


DBL 
:17C6 
RSC 
'BSI'1Y' 


DBL 
:17C6 
RSC 
·'BC/'IX' 


DBL 
:1786 
RSC 
''BC/'t'r'' 


DBL 
:1786 
** CLRSS 
18 - /'IISC.OPERRTIONS 
INVOLVING 
X 
* PREFIX 
DD 
* 
RSC 
'X+BC' 


DBL 
:9889 


742 
1018 
D8R8C4C5 
ASC 
/X+DE' 


743 
1814 
1998 
DBL 
'98/9 
744 
1816 
D8R8D8RO 
ASC 
/X+X 
/ 


745 
181A 
2998 
D8L 
'9829 
746 
10/C 
D8A8D3DO 
ASC 
/X+SP' 


747 
1820 
3998 
D8L 
'9839 
748 
1022 
D0C3D8A8 
ASC 
'PCX , 


749 
1026 
E998 
D8L 
'98E9 


750 
1028 
D8D4D8AO 
ASC 
·'XTX , 


751 
182C 
E398 
DBL 
'98£3 
752 
182E 
D3D0D8A8 
ASC 
'SPX 
/ 


753 
11332 F998 
D8L 
'98F9 
754 
'" 
755 
'" CLASS 
19 - MISC. 
OPERATIONS 
INVOLVING 
'r' 


756 
-'"PREFIX 
FD 
757 
'" 
758 
1834 D9ABC2C3 
ASC 
'~'+BC/ 


759 
1838 
13999 
D8L 
'9989 
768 
183R 
D9ABC4C5 
ASC 
/~'+DE' 


761 
103E 
1999 
DBL 
'9919 
762 
11340 09RBD9A8 
ASC 
'~'+'r' , 


763 
11344 2999 
DBL 
'9929 
764 
1846 
D9A8D3D13 
ASC 
'·~·+SP' 


765 
184A 
3999 
DBL 
'9939 
766 
104C 
O8C3D9AO 
ASC 
'PC~' 


... 


?6? 
1058 
E999 
D8L 
'99E9 
768 
1052 
08D4D9A8 
ASC 
'){n' 
769 
1056 
E399 
DBL 
'99E3 
7'18 1858 
D3DOD9AO 
ASC 
'SP~' , 


771 
185C 
F999 
D8L 
'99F9 
772 
-"'-"''''******-'''*'''***************************** 
773 
* 
774 
-'"ASSEM8H' 
MaN I TOR 
AND 
S~'f'1BOLTABLE 
HANDLERS 
775 
* 
776 
185E 
AF 
1'151'1 
ZAR 
777 
105F 
329FI3 
STA 
INFLAG 
SET 
ASM 
MODE 
TO MEMOR'r' 


778 
1062 
325F{~2 
STA 
NULLS 
779 
1865 
328813 
STA 
PAGE 


78f.!1868 
328CIF 
STA 
IL8888 
781 
186B 
3E8D 
MVI 
A.-'80 
782 
1860 
32C813 
STA 
TITLE 
783 
1878 
C07DOI 
CALL 
RKB 
784 
1873 
FED4 
CPI 
'·T' 
TAPE 
ASSEMBL~' 
REQUEST 
785 
1075 
C27EI8 
JNE 
1'151'12 
786 
1878 
329FI3 
STA 
INFLAG 
SET 
TAPE 
NODE 
787 
187B 
CD7D131 
CALL 
RKB 
788 
107E 
32A213 
R5M2 
STR 
LSTFLG 
789 
11381 FECC 
CPI 
'L' 


790 
1883 
CAR218 
JEQ 
AUST 
791 
1886 
FECF 
CPI 
'0' 
OBJECT 
TAPE? 
792 
1888 
CAR91 tl 
JEQ 
ROBJ 
793 
1138B FEC5 
CPI 
'E' 
ERROR 
SCAN? 
794 
188D 
CR9818 
JEQ 
ASN2A 
795 
1898 
FEDR 
CPI 
"2;- 


796 
1892 
C2E882 
JNE 
ERR 
797 
1895 
328CIF 
STA 
IL888(-l 
798 
1898 
AF 
ASM2A 
ZAR 
799 
1899 
321'1813 
STR 
PRFLAG 
CLEAR 
PRINT 


378 


Btltl 
Itl9C 32R I13 
8t.~I Itl9F C3Btlit.~ 
Bt12 ItlR2 32R'tll3 
8t.'I3 
If:lR~RF 
B04 
ItlR6 C39CI8 
8tl~ 
IOR9 
32RI13 
8tl6 
ItlAC RF 
8137 lORD 
32AOl3 
808 
lOBO 
CD7Dtli 
8139 1883 
FEAE 
81tl ItlB5 C2E082 
81 / ItlB8 CD8301 
8/2 
IOB8 
:~R9FI3 
813 
108E 
B7 
81 4 
I8BF 
C2DC 10 
815 
IOC2 
2R3B132 
BI6 
1t.'IC57C 
817 
IOC6 
B5 
818 
lOG? 
CAFI14 
8/9 
ItlCR CDRB02 
828 
IOCD 
CD2106 
821 
1000 
7D 
822 
ItiDl FE80 
823 
IOD3 
C21812 
824 
ItiD6 7C 
825 
IOD7 
FEOI 
826 
ItiD9 C21812 
827 
I8DC 
2R4782 
828 
IODF 
228913 
829 
18E2 
3R9FI3 
830 
IOE5 
87 
831 
18E6 
CRFEIO 
832 
IOE9 
22RFI3 
833 
IOEC 
228113 
834 
ItlEF 225502 
835 
It.'lF2224582 
836 
18F=i 210tltl0 
837 
IOF8 
223882 
838 
ItlF8 C31711 
839 
IOFE 
2R55132 
840 
1101 
22AFI3 
84 I 
I1134 22B I13 
842 
1/07 
3ARI13 
843 
118R 
B7 
844 
IlOB 
CR 171 I 
845 I I8E 2/ ::iEII 
846 
1111 
CD9901 
847 
1114 
CD74t.~1 
848 
III7 CDtiF I7 
849 
IIIR 
3RRt.~/3 
85t.~ IIID 
87 
851 
111£ 
CR24 II 
852 
1121 
CD3912 
853 I /24 CD83tli 
854 
1/27 
2R4?02 
855 
/12R 
228913 
856 
112D 
RF 
857 
112E 
325F82 


RS/'/3 


RUST 


5TA 
J/'/P 
5TA 
ZRR 
J/'/P 
STR 
ZRF: 
STR 
CRLL 
CPI 
JNE 
CRLL 
lOR 
ORR 
JNZ 
LHLD 
/,/0 ••' 
ORR 
JZ 
CALL 
CALL 
NOll 
CPI 
JNE 
/'/OV 
CPI 
JNE 
LHlO 
SHLD 
lOA 
ORA 
JZ 
SHLD 
SHlO 
SHlO 
SHlO 
LXI 
SHlO 
J/'/P 
LHLD 
SHlO 
SHLD 
LDA 
Ofm 
1Z 
LXI 
CALL 
CRLL 
CALL 
LDR 
ORA 
JZ 
CALL 
CALL 
LHlO 
SHLD 
ZAR 
STR 


OBFLAG 
AS/'/3R 
PRFLAG 


RS/'/3 
OBFLAG 


PRFLAG 
RK8 


ERR 
RENIND 
INFLRG 
R 
AS/'/4 
LNCNT 
R,H 
L 
NOPROG 
FBA 
FOR/'/AT 
A ..L 
'88 
NOEND 
A..H 
I 
NOEND 
8FR 
SRCPTR 
INFLAG 
R 
R/'/E/'/ 
5~'/'/LOC 
S'r'/,/PTR 
NXTCHR 
BFR 
H,.O 
LNCNT 
RSN5 
NXTCHR 
S~'/'/LOC 
S'r'NPTR 
OBFLRG 
A 
RS/'/5 
H,RDP/,/SG 
PRT 
SB 
PRSSI 
PRFLRG 
R 
AS/'/5R 
SRTST 
REWIND 
BFR 
SRCPTR 


SET 
PUNCH 
FLAG 


CLERR 
PRINT 
FLRG 
GET 
PERIOD 


TAPE 
RSSEI'1BL~'.,SET 
5'r'/'/BOLTABLE 
POINTERS 
CLERR 
BUFFER 


/'/E/'/OR'r' 
ASSE/'/BL'r'.SET 
S~'I'1BOLTRBLE 
POINTERS 


RESET 
POINTERS 
FOR 
2ND 
PRSS 


CLERR 
TAPE 
LERDER 
FLAG 


8~8 
859 
86tl 
861 
862 
863 
S64 
865 
866 
867 
868 
869 
870 
87/ 
872 
873 
874 
875 
816 
871 
878 
879 
8SB 
881 
882 
883 
884 
885 
886 
887 
888 
889 
89tl 
891 
892 
893 
894 
895 
896 
897 
898 
899 
900 
981 
902 
9133 
9B4 
985 
986 
987 
908 
989 
910 
911 
912 
913 
914 
915 


1131 
32BCI3 
1134 
3AA813 
113? 
B? 
1138 
CR4111 
113B 
CD9?14 
113E 
CDC914 
1141 
CDC619 
1144 
3AAtll3 
1147 
B? 
1148 
CA5111 
114B 
CDB812 
114E 
C09714 
1151 
3AAI13 
1154 
B7 
I I 55 
CA I 9tl1 
1158 
C0748 
I 
1158 
C31 9f.11 
115E 
D2C5CIC4 
117& 
SD 


1/71 
22ABI3 
11742R4982 
1177 
44 
1178 
40 
1179 
2ABI13 
117C 
118Sf.l8 
117F 
19 
1188 
CD33lN 
IIS3 
t19 
/184 
€.Ie 
1/85013 
1/86 
D2FFII 
I I 89 2AJ31 I 3 
118C 
EB 
118D 
&606 
118F 
219087 
1192 
7E 
1193 
12 
1194 
23 
1195 
13 
1196 
€.IS 
1197 
C292 
1 1 
119A 
3AABI3 
1190 
12 
119E 
13 
119F 
3RACI3 
IIR2 
12 
IIR3 
13 
IIA4 
EB 
IIR5 
22BI13 


****************************************** 
'" 
S'r'MBOL 
TABLE 
HRNOLERS 
***************************************** 
'"* S~'MENT 
ENTH'S 
THE 
S~'MBOL 
AT 
LOCATION 
"LABEL" 
'" 
INTO 
THE 
TRBLE 
WITH 
THE 
VALUE 
BEING 
THE 
* CONTENTS 
OF 
H&L 
ON 
ENTR~'. 
* 
S~'MENT 
SHLD 
LHLD 
MOV 
/'tOV 
LHLD 
LXI 
DRD 
CRLL 
DAD 
NOP 
NOP 
JNC 
5TO 
LHLD 
5~'NPTR 


XCHG 
MVI 
LXI 
/'10 V 
STRX 
INX 
INX 
DCR 
JNZ 
LDA 
STRX 
INX 
LDR 
STAX 
INX 
XCHG 
SHLD 
S'r'MPTR 


STA 
LDA 
ORA 
JZ 
CALL 
CALL 
AS/'16 
CRLL 
LOA 
ORA 
JZ 
CALL 
CALL 
ASM6AA 
LDA 
ORA 
JZ 
CRLL 
J/'1P 
RDPMSG 
ASC 
DATA 


LINZ 
PRFLAG 
A 
ASM6 
EJECT 
PGN8 
PRSS2 
PRFLRG 
R 
ASM6RR 
PS'r'MTB 
PRINT 
SORTED 
TRBLE 
EJECT 
RESTORE 
PAPER 
OBFLRG 
A 
MON2 
SB 
WAIT 
FOR 
SPACE 
/'10N2 
RETURN 
TO 
MONITOR 


'READ~' 
PUNCH .. 
SPACE'" 


'SD 


SVAL 
EOB 
8,H 
c..L 


S~'MPTR 
D ..8 
D 
NEGHL 
B 


SAl"E 
S~'N80L 
VALUE 
CHECK 
FOR 
BUFFER 
OVERFLOW 


8,6 
H ..LABEL 
A,M 
D 
H 
D 
B 
SE2 
S~'RL 
D 
D 
SVAL+I 
D 
D 


916 
9/7 
918 
919 
92f! 
921 
922 
923 
924 
925 
926 
927 
928 
929 
930 
931 
932 


IIA8 
2AADI3 
IIAB 
23 
IIAC 
22AOl3 
IIAF 
C9 


IIBf! 
22ABI3 
1183 
EB 
IIB4 
22A313 
1187 
2RAL>13 
IIBA 
7C 
118885 
118C CAEFfl 
118F 
228313 
IIC2 
2AAFI3 
IIC5 
£8 
IIC6 
2AABI3 
IIC9 
010608 
IICC 
£8 
IICD 
22A513 
IIDt1 
EB 
1101 
IA 
IID296 
1/03 
80 
IID4 
47 
IID523 
IID6 
13 
IID7 
f!D 
IID8 
C2DIII 
IIDB 
78 
IIDC 
£67F 
IIDE 
CAF611 
IIEI 
13 
IIE2 
13 
11£3 
2AB313 
IIE628 
IIE7 
2283/3 
IlEA 
7C 
IIE885 
IIEC 
C2C611 
liEF 
31 
II F8 E8 
IIFI 
2AA313 
IIF4 
E8 
IIF5 
C9 
IIF6 
IA 
IIF76F 
IIF8 
13 
IIF9 
IA 
/IFA 
67 
IIF881 
IIFC 
C3FOII 


933 
934 
935 
936 
937 
938 
939 
94t1 
941 
942 
943 
944 
945 
946 
947 
948 
949 
950 
951 
952 
953 
954 
955 
956 
9.51 
95B 
959 
96fJ 
961 
962 
963 
964 
965 
966 
961 
968 
969 
91fJ 
971 
97'~ 
.,.. 
973 


-* 
-* SERRCH SYMBOL TABLE FOR S~'MBOL NHOSE 
-* ADPRESS IS 
IN 
H&L ON ENTR~'. 
VALUE OF 


-* S~'M80L RETURNS IN 
HAND 
L.. 
CARRY 


-* OFF. 
IF 
SYMBOL NOT FOUND CARRY RETL~NS 


-* 
SRCST8 
SHLD 
S'v'AL 
XCHG 
SHLD 
LHLD 
MOV 
ORA 
JZ 
SHLD 
LHLD 
XCHG 
LHLD 
SVAL 
LXI 
B..6 


XCHG 
SHLD 
STLOC 
XCHG 
SRST2 
LDAX 
SUB 
ORA 
MOV 
INX 
INX 
OCR 
JNZ 
MOV 
ANI 
JZ 
INX 
INX 
LHLD 
DCX 
SHLD 
1'1010' 
ORA 
JNZ 
STMT 
STC 
RSTRD 
XCHG 
LHLD 
DSRVE 
XCHG 
RET 
F5~'1'1BL 
LDAX 
D 
MOil 
L ..A 
INX 
D 
LDAX 
D 
MOil 
H,A 
RSC 
JMP 
RSTRD 


LHLD 
INX 
SHLD 
RET 


NS~'MS 
H 
NSW'IS 


SYMBOL TABLE EMPTY 
SAllE 
COUNT 


DSAIlE 
NS."MS 
A.oH 
L 
ST1'1T 
SWICNT 
S~'1'1LOC 


D 
1'1 
B 
B.oA 
H 
D 
C 
SRST2 
A.oB 
:7F 
FS~'M8L 
D 
D 
S~'MCNT 
H 
S~'1'1CNT 
A ..H 
L 
SRSTI 


914 
1282 C31E12 
975 
1285 V3V9CDC2 
916 
121R 
8D 
977 
918 
1218 212412 
979 
121E 
CD9901 
98tl 1221 C31901 
981 
1224 CCC1D3D4 
982 
1238 8D 
983 
984 
985 
986 
987 
1239 2RRD/3 
988 
123C 
28 
989 
123D 
7C 
99tl 123E 
87 
99/ 
/23F 
F8 
992 
/240 
B5 
993 
124/ C8 
994 
/242 2287/3 
995 
/245 2283/3 
996 
/248 2RRF/3 
997 
1248 22R9/3 
998 
/24E 
2/0000 
999 
/25/ 2285/3 
000 
/254 2RR9/3 
8l~/ /257 f8 
002 
/258 
2/880(1 
l~83 1258 19 
tlt14125C 
22R913 
085 
125F f8 
tl06 1260 
22R713 
807 
1263 0606 
8l~8 1265 
7E 
089 
/266 E67F 
tl/t11268 F5 
011 
1269 
IR 
tl/2 126R 
E67F 
8/3 
126C 
4F 
014 
/26D 
FI 
015 
126E 
89 
tl16 126F 
DR9CI2 
8/7 
/272 
CA7812 
l~18 1215 C38112 
019 
1278 13 
B2tl 
1219 23 
821 
127A 
85 
022 
1218 C26512 
823 
127E 
C39CI2 
024 
1281 2RR913 
825 
/284 f8 
t126 1285 2RR113 
027 
1288 0608 
B28 
/28R 
IR 
029 
1288 
4E 
tU8 
128C 
77 
831 
1280 
79 


'1< 
NOENO 
NE2 


JNP 
ASC 
DATR 


LXI 
CRLL 
HIP 
RSC 
DRTR 


NE2 
'SYNBOL 
TRBLE 
OVERFLOW 


'8D 


H.oNENSG 
PRT 
NON2 
'LAST 
LINE 
NOT 
"END" 
, 


:8D 


'1< 


'1< 


'1< SORT 
SYMBOL 
TRBLE 
INTO 
RSCENDING 
ORDER 


'1< 
SRTST 
LHLD 
DCX 
NOV 
ORA 
RM 
ORR 
RZ 
SHLD 
SHLD 
LHLD 
SHLD 
LXI 
SHLD 
LHLD 
XCHG 
LXI 
DRD 
SHLD 
XCHG 
SHLD 
Mill 
~tO~' 
RNI 
PUSH 
LDRX 
RNI 
MOil 
POP 
CMP 
JRL 
JEG! 
JNP 
INX 
INX 
DCR 
JNZ 
JMP 
LHLD 
XCHG 
LHLD 
MVI 
WAX 
MOV 
MOI/ 
MOV 


NSYI'/S 
H 
A,H 
R 


NCf1P5 
S'r'MCNT 
5'r'MLOC 
SPTR2 
H,8 
NSUAPS 
5PTR2 


H.o8 
D 
SPTR2 


5PTR 
8,6 
R .. M 
:7F 
PSU 
D 
:7F 
C,A 
P5W 
C' 
SRT5T3 
SRT2A 
SRT5WP 
D 
H 
B 
SRTST2 
SRTST3 
5PTR2 


SPTR 
8.. 
8 
D 
C ..M 
M.oR 
R..C 


CHECK 
FOR 
1 OR 
8 
NO 
SORT 
IF 
ONL'r'ONE 
SYf180L 


CLERR 
SURP 
COUNTER 


LOW 
ADDRESS 
TO D&E 
INCREf1ENT 
TO H 
FORf1 HIGH 
RDDRESS 
IN H&L 
UPDRTE 
HIGH 
POINTER 


UPDRTE 
LOI" POINTER 
S'r'M80L POINTER 


032 
128£ /2 
033 
/28F 
23 
834 
1298 13 
035 
1291 85 
1336 1292 C28A12 
037 
1295 2A8513 
838 
1298 23 
839 
1299 
228513 
1348 129C 
2A83/3 
041 
129F 
28 
842 
12A8 
228313 
043 
12A3 
7C 
044 
12A4 
85 
045 
/2R5 
C25412 
046 
12A8 
2A8513 
847 
12RB 
?C 
048 
/2AC 
85 
049 
12RD 
C8 
05tl 
12RE 
2A8713 
051 
1281 28 
052 
1282 ?C 
053 
1283 
85 
054 1284 CS 
855 
1285 C342/2 
056 
(~57 
858 
(~59 1288 2ARD 13 
t168 
1288 
?C 
061 
128C 
85 
li62 
128D 
C8 
063 
128E 
2283/3 
064 
12C1 
2AAF13 
/365 12C4 
E8 
066 
12C5 
214813 
067 
12C8 
CD6C/4 
868 
12CB 
2/6913 
069 
/2CE 
CD6CI4 
07tl 
12D1 
214D13 
1371 12D4 
CD6C/4 
1372 12D7 
2169/3 
873 
12DA 
CD6C 14 
874 
12DD 
214813 
075 
12EO 
CD6C14 
076 
12E3 
CD6Stl1 
lin 
12E6 
L>AR422 
tl?8 
12£9 216202 
079 
/2EC 
t163C 
liSO 
12E£ 
3EAO 
881 
12Fa 
7? 


t182 12Ft 
23 
083 
12F2 
05 
8S4 
12F3 
C2FfJ12 
8S5 
12F6 
216202 
086 
12F9 
tlEt14 
887 
12F8 
li606 
t18S 12FD 
1A 
[~S9 /2FE 
77 


.'/< 


.'/< PRINT 
SYffBOL 
TRBLE 


.'/< 
PSYffT8 
LHLD 
NOV 
ORR 
RZ 
SHLD 
SW'1CNT 
LHLD 
S~'ffLOC 
XCHG 
LXI 
CALL 
LXI 
CALL 
LXI 
CALL 
LXI 
CRLL 
LXI 
CALL 
CALL 
JC 
LXI 
NVI 
ffVl 
ffOV 
INX 
DCR 
JNZ 
LXI 
ffl,'I 
PS~'2A 
/'IVI 
PS~'3 
LDAX 
1'10 'v' 


STRX 
INX 
INX 
DCR 
JNZ 
LHLD 
INX 
SHLD 
SRTST3 
LHLD 
DCX 
SHLD 
/'10 V 
ORA 
JNZ 
LHLD 
/'10 V 
ORA 
RZ 
LHLD 
DCX 
/'IO\-' 
ORA 
RZ 
J/'IP 


D 
H 
D 
8 
SWAP2 
NSNAPS 
H 
NSNRPS 
SW'1CNT 
H 
S~'/'ICNT 
R,H 
L 
SRTST1 
NSI4APS 
A,H 
L 


NCffPS 
H 
f/,H 
L 


SR TS TO 


NSYJ'1S 
A,H 
L 


H ..BLKLIN 
LPNT 
H ..ASTLIN 
LPNT 
H ..STB/'ISG 
LPNT 
H ..ASTLIN 
LPNT 
H ..8LKLIN 
LPNT 
UTCTCC 
RTI'10N 
H..KB 
8..60 
A·' 
/ 
.' 
J'1.. R 
H 
8 
PS~'2 
H,K8 
G..4 
8,6 
[1 
/'I .•R 


DO 
IT RGAIN.. 
SAM 
END 
OF 
PRSS.. CHECK 
SI4RPS 


SORT 
CONPLETE 
IF NO 
SI4APS 
DECREMENT 
MRSTER 
LOOP 
COUNT 


CHECK 
FOR 
ZERO 
RETURN 
IF NO 
COMPARES 
LEFT 
OTHERI4ISE 
DO IT RGAIN 


898 
/2FF 
13 
@91 1388 
23 
892 
1381 
85 
893 
1382 
C2FDI2 
894 
1385 
3ERfJ 
895 
1387 
77 


t196 
1388 
23 
997 
1399 
IR 
898 
138R 
13 
899 
1388 
F5 
IfJ8 
136C 
IR 
181 
138D 
/3 
IfJ2 
138E 
CD8513 
183 
1311 
77 
/84 
1312 
23 
1@5 1313 
7(3 
/86 
1314 
23 
1(37 1315 
FI 
/88 
1316 
CD8513 
1(39 1:"~/9 77 
IIt1 
131R 23 
III 
1318 
70 
112 
131C 23 
113 
131D 3ER6 
114 
131F 
77 
115 
132(3 23 
116 
1321 
77 
117 
1322 
23 
118 
1323 
77 
119 
1324 
23 
128 
1325 
E5 
121 
1326 
2AB313 
122 
1329 
28 
123 
132R 228313 
124 
132L> 7C 
125 
132E 
85 
126 
132F 
EI 
127 
133(3 CR3DI3 
128 
1333 
tlD 
129 
1334 
C2F812 
138 
1337 
CD4 I 13 
131 
133A 
C3E312 
132 
133D CD4113 
133 
1348 
C9 
134 
1341 
3ESD 
135 
1343 
77 
136 
1344 
216282 
137 
1347 
CD6CI4 
138 
134R C9 
139 
1348 
AO 
146 
134C 8D 
141 
134D ARROD3RO 
142 
1368 
8D 
143 
1369 
AARAAAAA 
144 
1384 
8D 
145 
146 
147 


INX 
D 
INX 
H 
DCR 
B 
JNZ 
PS~'3 
/'IVI 
R 
" 
" 
SET BLRNK 8EnJEEN 
S~'/'180L & 
V 
.' 
/'IOV 
/'I.•A 
INX 
H 
LDRX 
D 
GET HIGH 
VALUE 8'r'TE 
INX 
[I 
PUSH 
PSbJ 
LDRX 
[) 


IN,x,' 
D 
CRLL 
CN\/2HX 
/'10\1 
/'I.•A 
INX 
H 
/'101/ 
/'1,8 
INX 
H 
POP 
PSI4 
CRLL 
CNV2HX 


/'lOll 
/'I..R 
INX 
H 
/'lOll 
/'I..B 
INX 
H 
/'IVI 
A., , 


/'10',1 
/'I..R 
INX 
H 
/'10V 
/'I,R 
SET SPRCE BEnJEEN 
S~'/'I80LS 
INX 
H 
/'10V 
/'I,A 
INX 
H 
PUSH 
H 
LHLD 
S'r'/'ICNT 
DCX 
H 
5HLD 
5~'/'1CNT 
/'IOV 
R..H 
CHECK FOR LAST 
S~'/'IBOL 
ORA 
L 
POP 
H 
JZ 
P5~'ENL> 
DCR 
C 
LRST 
ON LINE? 
JNZ 
PS'r'2A 
CALL 
PS~'LN 
PRINT 
LINE 
J/'IP 
P5~'1 
P5'r'END 
CRLL 
PS~'LN 
RET 
PS~'LN 
/'IVI 
R.. '8D 
SET 
TER/'IINRTOR 
/'lOll 
/'I,R 
LXI 
H,KB 
CRLL 
LPNT 
RET 
8LKLIN 
DRTA 
'Rl1 
DATR 
'8D 
5T8/'15G 
R5C 
':f; 5 'r' /'I 8 
0 
L 
T A 8 
L E *' 


DATR 
'8D 
A5TLIN 
R5C 
'***************************' 


DRTR 
:8D 
** CONVERT BINAR~' 
R TO 2 HEX CHRRACTERS 
* 


384 


PRGE 
38 
Z80 
RESIOENT 
ED I TOR/ASSEMBLER 


148 
1385 
F5 
CN\/2HX 
PUSH 
PSj.J 
SAVE 
CHARACTER 
149 
1386 
CD9313 
CRLL 
ZHEX 
150 
/389 
47 
110\1 
B ..R 
151 
138A 
F/ 
POP 
PSI4 
RETRIEVE 
CHARACTEF: 
152 
138B 
IF 
RAR 
153 
138C 
IF 
RRF: 
154 
138D 
IF 
RAR 
155 
138E 
IF 
RRR 
156 
138F 
CD:~313 
CALL 
ZHEX 
157 1392 C9 
RET 
15& 
1393 
£60F 
ZH£.I.: 
ANI 
'F 
159 
1395 
FEl~A 
CPI 
10 
160 
/397 DA9CI3 
JAL 
ZH2 
161 
139A 
C607 
RDI 
7 
/62 
139C 
C686 
2H2 
ADI 
'BO 
163 
139E 
C9 
RET 
164 
* 
165 
139F 
BO 
INFLAG 
*** 
166 
13AO 
00 
PRFLAG 
*** 
/67 
13AI 
OB 
OBFLAG 
*** 
168 
/3A2 
00 
LSTFLG 
*** 
169 
13A3 
OOt~(I 
DSAVE 
DBL 
0 
170 
13A5 
Otl00 
snoc 
DBL 
tl 
171 
13A7 
BOOO 
SPTR 
DBL 
t1 
172 
13R9 
OtWO 
SPTf."2 
DBL 
0 
173 
13RB 
OOt~O 
SIIAL 
DBL 
0 
1?4 
13RD 
ftOOO 
NS~'MS 
DBL 
0 
175 
13RF .t~t~OO 
S~'I1LOC 
DBL 
(I 
176 
1381 
Otl0tl 
S~'MPTR 
DBL 
tl 
17'7 
1383 
lWBO 
S'T'MCNT 
DBL 
0 
, , 
I?S 
1385 
OflOO 
NSj.JAPS 
DBL 
0 
179 
13B7 
Ot~Ot1 
NCNPS 
DBL 
0 
18tl 1389 
000t1 
Sf<'CPTR 
DBL 
0 
181 
138B 
Bt1 
PAGE 
*** 
/82 
138C 
tl0 
LINZ 
*** 
183 
1380 
DBCIC7C5 
PGNO 
ASC 
''PAGE 
184 
13C2 
ftO 
POI 
*** 
185 
130 
00 
PD2 
*** 
/86 
13C4 
AOROAOA(I 
ASC 
/87 
13C8 
TITLE 
RES 
3S' 
/88 
13EE 
8D 
PATA 
'&D 
189 
13EF 
TBUF 
RES 
72 
190 
* 
/91 
* FETCH 
SOURCE 
RECORD 
AND 
FORI1RT 
192 
* 
193 
1437 
3A9FI3 
FSRCD 
LDA 
INFLAG 
194 
143R 
87 
ORA 
A 
195 
1438 
CA58/4 
JZ 
FI1RCD 
RECORD 
IN 
I1EI10R'r' 
196 
143£ 
CDC505 
CALL 
RTR 
GET 
RECORD 
FRO/'1 TRPE 
197 
1441 
2162ft2 
LXI 
H ..K8 
198 
1444 
IIEFI3 
LXI 
D ..T8UF 
/'101/ERECORD 
TO 140RK BUFFER 
1:~9 1447 
t~648 
/'1V I 
8 
7'~ 
,'I 
••. 


200 
1449 
?E 
FSRCD2 
/'101/ 
A,/'1 
2131 144A 
/2 
STAX 
D 
202 
1448 
23 
INX 
H 
203 
144C 
13 
IN.x,· [) 
2(14 
144D 
05 
DCR 
8 
2135 
144E 
C24914 
JNZ 
FSRCD2 


206 
1451 21EFI3 
201 
/454 
CD2106 
288 
1451 C9 
289 
/458 
2R89 13 
210 
1458 CD21136 
211 
145E 
2A8913 
212 
1461 7E 
2/3 
1462 23 
214 
/463 
FE80 
215 
1465 C26114 
216 
1468 228913 
211 
/468 
C9 
2/8 
219 
22ft 
221 
222 
223 
224 
225 
226 
227 
228 
146C 
3E80 
229 
146E 
C0770 
I 
230 
1471 
3E8A 
231 
/413 
CD7781 
232 
/476 
3EFF 
233 
1418 CD7701 
234 
1478 7E 
235 
147C 
23 
236 
/47D 
FE80 
231 
141F 
CR88/4 
238 
/482 
C07701 
239 
1485 C378/4 
240 
1488 3ABC /3 
241 
1488 30 
242 
148C 
328C 
13 
243 
/48F 
CO 
244 
149t1 CD9714 
245 
1493 CDC914 
246 
1496 C9 
247 
248 
249 
250 
/497 
3E80 
251 
/499 
C07?0 
1 
252 
149C 3R8C 13 
253 
149F 
C683 
254 
14AI 
47 
255 
/4A2 
3E8R 
256 
14A4 
C077£/1 
25? 
14R1 
l~5 
258 
14R8 
C2A414 
259 
14R8 
l164S 
260 
/4Af) 
3ERD 
26/ 
/4AF 
C07781 
262 
1482 t15 
263 
1483 C2AF 14 


LXI 
CALL 
RET 
LHlO 
CRLL 
LHLD 
1'I01l 
INX 
CPI 
JNE 
SHlO 
RET 


H, T8UF 
FORNRT 


SRCPTR 
FORNRT 
SRCPIR 
R.oN 
H 
:8D 
FNRCf)2 
SRCPTR 


*** PRINT 
RND 
PAGE 
CONTROL 
ROUTINES 
* FOR 
RSSEI'I8LY 
OUTPUT 
*** PRINT 
LINE 
HHOSE 
AL>DRESS 
IS 
IN 
H,~L 
ON 
ENTR'r'. 
* PRINT 
IS 
ENDED 
WHEN 
C.R. 
OR 
8ACK5LA5H 
IS 
* ENCOUNTEREf). 
LINE 
15 PRECEEf)EO 
8'r' CRLF. 
* 
LPNT 
1'1VI 
CRLL 
I'IVI 
CRLL 
1'I1l1 
CALL 
NOll 
INX 
CPI 
JZ 
CALL 
JI'IP 
lOR 
DCR 
5TA 
RNZ 
CRLL 
CRLL 
RET 


A.o '8f) 
CPNT 
A .. 'SR 
CPNT 
A.o 'FF 
CPNT 
R.oN 
H 
'8D 
LP2 
CPNT 
LP3 
LINZ 
R 
LINZ 


I'IVI 
CRLL 
lOR 
AD! 
NO~' 
1'1V I 
CALL 
DCR 
JNZ 
1'11/1 
NIlI 
CRLL 
DCR 
JNZ 


** EJECT 
PAPER 


'1< 
EJECT 
R.. '80 
CPNT 
LINZ 
3 
B .. A 
R.. '8A 
CPNT 
8 
EJ2 


R ...."_/ 


CPNT 
B 
EJ3 


264 
14B6 
3ESD 
265 
14B8 
CD7?&1 
266 
14BB 
3ESA 
267 
14BD 
CD7?&1 
26S 
14Ct1 CD7?&1 
269 
14C3 
3E3C 
27tl 
14C5 
32BC 13 
27/ 
14C8 
C9 


/'tVI 
CALL 
I'1VI 
CRLL 
CALL 
1'1V I 
5TA 
RET 


R.- 'SD 
CPNT 
A.-'SA 
CPNT 
CPNT 
A.- 6tl 
LINZ 


••..• -;'1 
•.., 


0::1'0:: 
273 
274 
275 
276 
277 
278 
279 
288 
281 


.'/< 


.'/< PRINT 
AND 
UPDATE 
PAGE 
NUI'1BER 


.'/< 
14C9 
3A8BI3 
PGNS 
LDA 
PAGE 
14CC 
3C 
INR 
A 
14CL> 32BBI3 
STR 
PAGE 
14Ptl 
tl6t1tl 
1'1VI 
&,101 
14D2 
D6&A 
PGNSI 
SUI 
If' 
CONVERT 
TO DECINAL 
14D4 
FADBI4 
JI'1 
PGNS2 
14D7 
&4 
INR 
B 
14P& C3D214 
JI'1P 
PGNSI 
/4DB 
C68A 
PGNS2 
ADI 
'BA 
14DD 
32C313 
STA 
PD2 


/4H'l 
78 
MOil 
A,B 
14EI 
C6Bt1 
AliI 
'Bt1 
14E3 
32C213 
STA 
PDI 
14E6 
21BDI3 
LXI 
H ..PGNO 
14E9 
CD6CI4 
CALL 
LPNT 
14EC 
2B 
DCX 
H 
14ED 
CD6CI4 
CALL 
LPNT 


14Ft1 C9 
RET 
PDIIC 
EQU 
0 
/4FI 
21FAI4 
NOPROG 
LXI 
H,NPI'1SG 
14F4 
CD99EtI 
CRLL 
PRT 
14F? 
C31981 
JI'1P 
1'10N2 


14FA 
CECFRt'lDEt 
NPI'1SG 
ASC 
'NO PROGRRI'1 IN MEMOR'r" 


150E 
SD 
DATA 
:80 


283 
284 
285 
286 
287 
288 
289 
29t1 
29/ 
292 
293 
294 
295 
296 
297 
298 
299 
3tltl 
3t11 
302 
3Et3 
3t14 
305 
306 
307 
308 
389 
310 
311 


.'/< 


.'/<* OPERAND 
FIELD 
ANAL~SIS 
SECTION 


.'/<* ENTER 
WITH 
RDDRESS 
OF 
1ST CHARRCTER 
IN D&E 


.'/< EXIT 
WITH 
TERMINATING 
CHRRACTER 
IN A, 
FIELD 


.'/< CLASS(ES) 
IN B, 
FIELD 
VALUE 
IN H&L. 
* UPON 
RETL~N 
D&E 
CONTAIN 
THE 
ADDRESS 
OF 
THE 
CHAR- 


.'/< ACTER 
AFTEF: THE 
ONE 
CRUSING 
TERI'1INATION OF 
THE 


.'/< SCAN. 
CARR~ 
RETURNS 
OFF 
IF 
THE 
RESULT 
* CRN 
BE 
HELD 
IN 8 BITS, 
ON 
IF 
IT CRNNOT 


.'/< 
* 
.'/< 
FIELD 
CLRSSES' 


.'/< 


.'/< -2 
LENGTH 
ERROR. 
NUMERICRL 
FIELD 
RESULTS 
* 
IN NUMBER 
WHICH 
CANNOT 
BE 
HELD 
IN 
16 BITS. 


.'/<* -I 
UNDEFINED 
S~MBOL 
OR UNDEFINED 
FIELD 
T~PE. 


.'/< 
* 
0 
NULL 
FIELD. 
FIRST 
CHARACTER 
IS BLRNK 
OR 


.'/< 
COI'1MA. 


.'/< 


313 
314 
315 
316 
317 
3/8 
319 
328 
32/ 


322 
323 
324 
325 
326 
327 
328 
329 
338 
331 
332 
333 
334 
335 
336 
337 
338 
339 
348 
341 158F AF 
342 1518 32D316 
343 1513 3EAB 
344 1515 218B8t1 
345 
1518 22D?l6 
346 151B 218(-1130 
347 151E FEAB 
348 
1528 CA28/5 
349 1523 FERD 
350 
1525 C23815 
351 
/528 32D416 
352 152B IA 
353 /52C /3 
354 152D C31BI5 
355 15313FERO 
356 
1532 CA9/16 
357 
1535 FEAC 
35S 
1537 CR9/16 
359 153A FESD 
368 153C CA9116 
361 153F FEff7 
362 1541 CAB/15 
363 1544 FECB 
364 
1546 CAF815 
365 1549 FEBA 
366 154B CA5716 
367 154E FEB8 
368 
1558 DACFI6 
36.9 1553 FEBA 
378 
1555 DAWI6 
371 1558 FECI 
372 /55R DACFI6 
373 155D FEDB 
374 155F D2CFI6 
375 
376 
377 
378 
1562 
IB 
379 
1563 21RBR8 


'"-* 
-* 
2 


-* 
'" 4 
'" 
:+: 
8 
'" 
'" 
16 
'" 
:+: 32 
'" 
'"-* 
THE CLAS5 RETURNED IN B 15 THE LOGICRL SUM OF 
'"THE CLASSES OF THE COMPONENT FIELDS OF THE ENTIRE 
'"STRING. 


>/< 


'" 
'"FRNLYZ 
ZAR 
5Tff 
/'tV I 
LXI 
FAN I 
SHLD 
FRN/R 
LXI 
CPI 
JEll 
FRN2 
CPI 
'-' 


JNE 
FRN3 
STR 
FRNOP 
LDRX 
D 
INN 
D 
HIP 
FRNIR 
CPI 
JEll 
FRNEND 
CPI 
'..' 


JEll 
FRNEND 
CPI 
'SD 
JEll 
FRNEND 
CPI 
'R7 
JEll 
FRSC 
CPI 
'lr 
JEll 
FOCT 
CPI 
,., 


JEll 
FHXDC 
CPI 
'8' 


JRL 
FUNDEF 
CPI 
'BR 
JAL 
FDECML 
CPI 
"R/ 


JRL 
FUNDEF 
CPI 
'[ , 
JGE 
FUNDEF 


ASCII STRING. FOR THI5 FIELD n'PE THE VRLUE 
RETURNED IN H&L IS THE LENGTH OF THE STRING 


Fn'PE 
R.o 
/+/ 
H,l~ 
FNRSLT 
H .•8 


'" 
>/< 5YMBOLIC FIELD 


.'1< 


CLERR RE5UL T RREA 
STORE RESULT 
CLERR PREVIOU5 RESULT 
CHECK FOR OPERRTOR 


BLRNK? 
~'ES,EXIT 
COMMA 
~·ES.. EXIT 
CARRIRGE RETURN? 


APOSTROPHE? 
RSCII FIELD 
RT SIGN? 
OCTAL FIELD 
COLON 
HEXRDECIMRL FIELD 
TEST FOR DECIMRL 
UNDEFINED IF LESS 


388 
381 
382 
383 
384 
385 
386 
387 
388 
389 
398 
391 
392 
393 
394 
395 
396 
397 
398 
399 
488 
481 
482 
483 
4(14 
485 
486 
487 
488 
4l~9 
4/8 
4/1 
412 
413 
414 
415 
416 
417 
418 
419 
428 
421 
422 
423 
424 
425 
426 
427 
428 
429 
438 
431 
432 
433 
434 
435 
436 
437 


1566 220916 
1569 220BI6 
156C 22DOl6 
156F 21D916 
1572 8686 
1574 IA 
1575 13 
1576 CDADI6 
15?9 OA8RI5 
157C 
77 
15?0 23 
157E 85 
15?F C2?415 
1582 IA 
1583 13 
1584 CORDI6 
158? D2CFI6 
158R F5 
1588 210916 
158E CD88 1 1 
1591 OACEI6 
1594 3RD316 
1591 F618 
1599 320316 
159C 3A0416 
159F FEAD 
15RI C2R715 
15R4 C03384 
15A? 44 
15R8 4D 
15R9 2RD?16 
15RC 89 
/5RD FI 
15RE C31815 


1581 IR 
15B2 818a8tl 
15B5 IA 
15B6 13 
1587 FER7 
1589 CRC715 
15BC FE8D 
15BE CRCFI6 
15CI 48 
15C2 47 
15C3 23 
15C4 C3B515 
15C1 IR 
15C8 13 
15C9 FER8 
15CB CRDBI5 
15CE FERC 
15D8 CROBI5 
15D3 FE80 
1505 CRDBI5 
1508 C3CFI6 


SHLD 
SHLD 
SHLD 
LXI 
/'II/I 
FS'r'/'I1LDAX 


INX 
CRLL 
JC 
/'10 V 
INX 
DCR 
JNZ 
LDRX 
INX 
CRLL 
JNC 
FANEOS 
PUSH 
LXI 
CRLL 
JC 
LDR 
ORI 
FRN8 
STR 
FRNEOL 
LDR 
CPI 
JNE 
CRLL 
FRNE2 
/'IO~' 


/'101/ 
LHLO 
ORD 
POP 
J/'IP 


'".'/0 RSCI I FIELD 


'"FRSC 


FBUF 
FBUF+2 
FBUF+4 
H..FBUF 
B ..6 
o 
D 
ECHECK 
FRNEOS 
/'I,R 
H 
8 
FSW'/I 
o 
D 
ECHECK 
FUNDEF 
PSI4 
H,FBUF 
SRCSTB 
FUNDEF-I 
FT'r'PE 
FS~'/'IBT 
FTVPE 
FANOP 


FRNE2 
NEGHL 
B,H 
C,L 
FNRSLT 
B 
PS/4 
FRNI 


LDRX 
LXI 
LDRX 
INX 
CPI 
JEll 
CPI 
JEll 
/'10 V 


/'101/ 
INX 
HIP 
LDRX 
INX 
CPI 
JEll 
CPI 
Jm 
CPI 
JEQ 
J/'IP 


D 
B,8 
Do 
: R?' 
FRSC2 
'8D 
FUNOEF 
C,B 
B,R 
H 
FRSCI 
D 
D 


FRSC3 


FRSC3 
'8D 
FRSC3 
FUNDEF 


RDDRESS 
TO INDEX 
CHRRRCTER 
COUNT 


GET 7TH CHRRRCTER 


CHECK FOR 
TER/'IINATOR 
BRD S'r'/'IBOL 
IF NOT 
TER/'IINATOR 
SRVE LRST CHRRRCTER 
BUFFER 
ADDRESS 
TO INDEX 
SERRCH 
THE S'r'/'IBOL 
TRBLE 
UNDEFINED 
S~'/'IBOL 
OTHERUISE 
SET T'r'PE 


GET PREVIOUS 
RESUL T 
CO/'IBINE/4ITH NEW RESULT 
RETRIEI/E TERMINRTOR 
RND GET NEXT COMPONENT 


SECOND RPOSTROPHE? 
'r'ES 
..EXIT 
C.R. 
IN STRING? 
YES..GRRBRGE 


BUMP FIELD COUNT 


GET CHRRRCTER 
RFTER 
TER/'IINRT 


CHECK FOR LEGAL 
TER/'IINRTOR 


ONLY BLRNK, 
CO/'lMROR 


CRRRIRGE 
RETURN 
RLLOI4EO HERE 


OTHER/4ISE GRRBRGE 


PRGE 
43 
280 
RESIDENT 
EDITOR/RSSEMBLER 


438 150B 
F5 
FRSC3 
PUSH 
PSI4 
439 15DC 
79 
MOV 
R,C 
440 15DO 
320616 
STR 
NLRCHR 
441 15E13 78 
MOV 
R ..B 
442 15EI 
32D516 
STR 
LRCHRR 
443 15E4 
3RD316 
LOR 
FT'r'PE 
444 15£7 
F620 
ORI 
FRSCBT 
445 15E9 
32D316 
STR 
FT'r'PE 
446 15EC 
47 
Mall 
B,A 
CLRSS 
TO 8 
447 15EO 
FI 
POP 
PS/4 
TERMI NR TOR 
TO A 
448 15EE 
87 
RSC 
449 15EF 
C9 
RET 
458 
'" 
451 
'" 
OCTRL 
FIELO 
452 
'" 
453 15F0 
86813 
FOCT 
NVI 
B ..0 
CLERR 
UPPER 
/40RK REGISTER 
454 15F2 
IR 
LORX 
0 
455 15F3 
13 
INX 
0 
456 15F4 
COROl6 
CRLL 
ECHECK 
457 15F7 
ORI416 
JC 
FOENO 
458 15FR 
FEB13 
CPI 
'8' 
CHECK 
LEGITI/'IRTE OCTAL 
459 15FC 
ORCFI6 
JRL 
FUNOEF 
468 15FF 
FEB8 
CPI 
"'8'" 


461 
1681 
D2CFI6 
JGE 
FUNDEF 
462 1604 
E607 
RNI 
7 
463 1686 
4F 
/'10 
V 
C,R 
SRVE 
INCO/'IING OIGIT 
464 1607 
7C 
NO~' 
R,H 
CHECK 
FOR 
O.~RFLO/4 
465 1688 
FE28 
CPI 
32 
466 16aR 
02CBI6 
JGE 
FLNGTH 
LENGTH 
ERROR 
467 1680 
29 
ORO 
H 
SHIFT 
LEFT 
3 
468 168E 
29 
ORO 
H 
469 168F 
29 
DRO 
H 
478 1618 
09 
ORO 
B 
/'IERGE INCONING 
OIGIT 
471 1611 
C3F815 
J/'IP 
FOCT 
472 1614 
F5 
FOENO 
PUSH 
PSI4 
473 1615 
3RD316 
lOR 
FT'r'PE 
474 1618 
F688 
ORI 
FOCTBT 
475 161R 
C39915 
J/'IP 
FRN8 
476 
'" 
477 
'" 
DECIMAL 
FIELO 
478 
".. 
479 16/l> 18 
FOEC/'IL 
OCX 
0 
488 161E 
IR 
FOC2 
lORX 
0 
481 
16/F 
/3 
INX 
0 
482 1628 
CORDl6 
CRLL 
ECHECK 
483 /623 
DR4EI6 
JC 
FDCENO 
484 /626 
FEB8 
CPI 
'·8' 


485 1628 
DRCF/6 
JRL 
FUNDEF 
486 162B 
FEBR 
CPI 
'BR 
487 /620 
D2CFI6 
JGE 
FUNOEF 
488 1638 
E68F 
RNI 
'F 
/'IRSKOUT 
RSCII 
BITS 
489 /632 29 
ORO 
H 
PREVo 
RESUL T TINES 
Il3 


498 /633 
ORCB/6 
JC 
FLNGTH 
49/ /636 44 
/'10 
V 
B,H 
492 /637 
40 
/'10V 
C,L 
493 /638 29 
ORO 
H 
494 /639 
ORCBI6 
JC 
FLNGTH 
495 /63C 
29 
ORO 
H 
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PRGE 
44 
280 
RESIDENT 
EDITOR/RSSE/'/BLER 


496 
163D 
DRCBI6 
JC 
FLNGTH 
49? 
1640 89 
DRD 
B 
498 
1641 DRCBI6 
JC 
FLNGTH 
499 
1644 
4F 
/'/010' c..R 
500 
1645 0600 
1110'1 B,{;I 
501 
164? 09 
DRD 
B 
RDD 
NE14 DIGIT 
582 
1648 
DRCBI6 
JC 
FLNGTH 
503 
164B 
C31EI6 
JMP 
FDC2 
584 
164E 
F5 
FDCEND 
PUSH 
PSI4 
585 
/64F 
3RD316 
lOR 
FH'PE 
586 
/652 
F684 
ORI 
FDECBT 
58? 
1654 
C39915 
JI1P 
FRN8 
588 
* 
589 
* HEXRDECII1RL 
FIELD 
5f('l 
* 
5/1 
165? 8688 
FHXDC 
1110'1 B ..13 
512 
1659 
IR 
FHXDC8 
LDRX 
D 
513 
165R 
13 
INX 
D 
514 
165B 
CDADI6 
CRLL 
ECHECK 
515 
/65E 
DR8816 
JC 
FHXEND 
516 
1661 FEB8 
CPI 
'8' 
CHECK 
FOR 
LEGRL 
HEX 
51? 
1663 
DRCFI6 
JRL 
FUNDEF 
518 
1666 
FEBR 
CPI 
'BR 
519 
1668 
DR7716 
JRL 
FHXOK 
52tl 166B 
FECI 
CPI 
'R' 


521 
166D 
DRCFI6 
JRL 
FUNDEF 
522 
1678 
FEe? 
CPI 
/6" 


523 
/6?2 D2CFI6 
JGE 
FUNDEF 
524 
1675 
D607 
SUI 
7 
BIRS 
CHRRRCTER 
DOI4N 
525 
1677 
E60F 
FHXOK 
RNI 
'F 
CLERR 
RSCII 
BITS 
526 
1679 
4F 
11010' C.'fI 
527 
167A 
?C 
11010' R,H 
CHECK 
FOR 
OVERFL014 
528 
167B 
FEW 
CPI 
16 
529 
167D 
D2CBI6 
JGE 
FLNGTH 
538 
1688 
29 
DRD 
H 
531 
1681 
29 
DRD 
H 
532 1682 
29 
DRD 
H 
533 
1683 
29 
DRD 
H 
534 
1684 
89 
DRD 
B 
I1ERGE NEI4 DIGIT 
535 
/685 
C35916 
JI1P 
FHXOC8 
536 
1688 
F5 
FHXEND 
PUSH 
PSI4 
53? 
/689 
3RD316 
LDA 
FTYPE 
538 
168C 
F682 
ORI 
FHEXBT 
539 
/68E 
C39915 
JI1P 
FRN8 
540 
* 
54/ 
* EXIT 
POINT 
542 
* 
543 
169/ 
2AD716 
FANENO 
LHLD 
FNRSLT 
EXPRESSION 
VALUE 
TO H&L 
544 
1694 
32D916 
STA 
FBUF 
SAVE 
LAST 
CHRRACTER 
545 
1697 
3RD316 
LDA 
FTYPE 
546 
169R 
41 
11010' 8 ..R 
CLASS 
TO B 
547 
169B 
7C 
110'.1 R,H 
CRN 
IT BE 
HELD 
IN 8 BITS? 


548 
169C 
B1 
ORR 
A 
549 
169L> CRA516 
JZ 
FEND 


558 
16RB 
3C 
INR 
A 
RLL 
ONES? 


55/ 
16AI 
C2R916 
JNZ 
FSTC 
552 
16R4 
B7 
RSC 
OK 
FOR 
8 BITS 
553 
/6RS 
3RD9/6 
FEND 
LDA 
FBUF 
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554 
16R8 C9 
555 
16R9 37 
556 
16RR C3A516 
557 
558 
559 
568 
16AD FEA8 
56/ 
16AF CRC816 
562 
16B2 FEAC 
563 
1684 CRC916 
564 
16B7 FE8D 
565 
1689 CAC816 
566 
168C FERB 
567 
168E CRC816 
568 
16CI FERD 
569 
16C3 CRC816 
578 
16C6 8? 
57/ 
16C7 C9 
572 
16C8 
18 
573 
16C9 37 
574 
/6CA C9 
575 
576 
57? 
578 
16CB 86FE 
579 
16CD C9 
588 
581 
582 
583 
16CE FI 
584 
16CF 86FF 
585 
16D1 B7 
586 
16D2 C9 
587 
588 
589 
598 
16D3 88 
591 
16D4 88 
592 
16D5 
t18 
593 
16D6 138 
594 
16D7 88138 
595 
16D9 
596 
597 
598 
599 
6t~13 
681 
682 
683 
684 
16DF E5 
685 
16E8 C5 
686 
16EI 219D87 
687 
16£4 7E 
688 
16E5 FECI 
689 
16E7 DA13BI7 
618 
16ER FEDB 
611 
16£C D28BI7 


REf 
FSTC 
STC 
J/'IP 
FEND 
'"'"CHECK 
FOR 
TERNINRTOR 
'"ECHECK 
CPI 
JHJ 
ECH2 
CPI 
'.," 
JEQ 
ECHR 
CPI 
'8D 
JEQ 
ECH2 
CPI 
,+" 


JEQ 
ECH2 
CPI 
,-,., 


JEQ 
ECH2 
RSC 
REf 
DCX 
D 
STC 
RET 


'*'"LENGTH 
ERROR 


'*FLNGTH 
NVI 
8,-2 
REf 
'"'* UNDEFINED 
SYNBOL 
OR FIELD 
TYPE 


'" 
POP 
FUNDEF 
NVI' 
RSC 
REf 


'* 
'"/"ORK SPACE 
'"FH'PE 
"''''''' 
FANOP 
'*'*'" 
LRCHRR 
"'** 
NLRCHR 
"'** 
FNRSLT 
DBL 
FBUF 
RES 
FHEX8T 
El~U 
FDECBT 
EQU 
FOCT8T 
EQU 
FSYNBT 
EQU 
FRSCBT 
EQU 


'*'* CHECK 
LRBEL 


'*SLL8L 
PUSH 
PUSH 
LXI 
NOV 
CPI 
JRL 
CPI 
JGE 


~'RLIDIH' 


H 
8 
H,LR8£L 
R,N 
'R' 
SLLJ 
'[ , 
SLLJ 


PAGE 
46 
ZS8 RESIDENT 
EDITOR/ASSE1'1BLER 


6/2 
16EF 23 
INX' 
H 
613 
16FO 
0605 
1'1~'I 8..5 
614 
16F2 
?E 
SLL2 
NOV 
R,N 
615 
16F3 
FEAB 
CPI 
'+' 


616 
16F5 
CROBI7 
JHl 
SLLJ 
617 
16F8 
FEAD 
CPI 
,'-/ 


6/8 
16FA 
CROBI7 
JEO 
SLLJ 
619 
16FD 
FEAC 
CPI 
, 


.' , 


620 
16FF 
CAOBI7 
Jm 
SLL3 
621 
1702 
23 
INX' 
H 
622 
17t13 t15 
OCR 
B 
623 1704 
C2F216 
JNZ 
SLL2 
624 /707.87 
RSC 
625 
1708 
CI 
POP 
B 
626 
17t19 EI 
POP 
H 
6':"'7 
170R 
C9 
RET 
.., 
628 
170B 
37 
SLL3 
STC 
629 
l71lC CI 
POP 
B 
630 
170D 
EI 
POP 
H 
631 
1713E C9 
RET 
632 
'" 
633 
:/< ASSENBLER 
PASS 
634 
:/< 
635 170F 
21011110 
PASS/ 
LXI 
H ..0 
636 
I?J2 
22RDI3 
SHLO 
NS~'/'1S 
637 1715 
228.'1/8 
SHLD 
ILC 
638 
/7/8 
228R/8 
SHLD 
ORGVRL 
639 1718 
22BEI8 
SHLD 
TLFLAG 
64tl171E 
22RC22 
SHLD 
P2LNO 
641 
/721 
CD3714 
PIB 
CRLL 
FSRCD 
642 1724 
CDAOl9 
CALL 
CN I/L NO 
643 /727 
2AB8/8 
LHLD 
ILC 
644 
/?2R 
3R9D07 
LOR 
LRBEL 
645 
/72D 
FERA 
CPI 
"':fr" 


646 
1?2F 
CA2117 
JEO 
PIB 
647 1732 
3A8407 
LDA 
CLASS 
648 1735 87 
ORA 
A 
649 1736 
C27517 
JNZ 
PIC 
650 
/739 
3R8507 
LDR 
SKEL 
651 
I73C 
FEO? 
CPI 
7 


652 173E 
C21517 
JNE 
PIC 
653 1741 
CDDFI6 
CALL 
SLLBL 
654 1744 
DR56 I9 
JC 
PI EOUR 
655 /747 
I/RB07 
LXI 
D ..OPNDF 
656 174R 
CDOFI5 
CRLL 
FRNL'r'Z 
657 1740 
FE8D 
CPI 
:80 
658 174F 
CR57 I7 
lEa 
PIBI 
659 /752 FEAO 
CPI 
66111754 
C2211'? 
JNE 
PIB 
661 
1757 
78 
PIBI 
1'10V 
R ..B 
662 
1758 
FEl12 
CPI 
:2 
663 175R 
FR2EI9 
.J( 
PIERFL 
664 1750 
FE2l1 
CPI 
FRSCBT 
665 175F 
DA7517 
JRL 
PIC 
666 /762 
CR68 I7 
JEQ 
PIB2 
667 
1765 
D22EI9 
JGE 
PIERFL 
668 1768 
?D 
PIB2 
1'10V 
R,L 
669 1769 
B7 
ORA 
R 


393 


CLERR 
S~'/'1BOLCOUNT 
AND 
LOCRTION 
COUNTER 
SET 
ORIGIN 
TO ZERO 
CLERR 
TITLE 
FLAG 


GET 
SOURCE 
RECORD 


LOCRTION 
COUNTER 
TO H&L 
CHECK 
FOR 
CON1'1ENT 


GET 
EQU 
FIELD 
VRLUE 
END 
IN 
C.R. 
OR 
BLANK 


67tl 176A 
FA2117 
J/'I 
PIB 
67/ 
176D 
FE83 
CPI 
3 
612 
176F 
D22//7 
JGE 
PIB 
613 
1772 
2AD516 
LHLD 
LACHRR 
674 
1775 
3A9Dt17 
PIC 
LDA· 
LABEL 
14AS THERE 
A LABEL? 
675 
1778 
FEAO 
CPI 
676 
I??R 
CA9FI7 
JEl~ 
PIE 
677 I?7D 
CDDFI6 
CRLL 
SLL8L 
678 
1780 PA7EI9 
JC 
PILERR 
679 
1783 228CI8 
SHLD 
PI TI'1P 
SAVE 
S~'NBOL 
VALUE 


G8tl 1786219D07 
LXI 
H ..LABEL 
681 
1789 CD8011 
CALL 
SRCSTB 
S'r'/'IBOL 
ALREAD~' 
IN 
TABLE? 
682 
178C 
DA99 17 
JC 
PID 
NO 
683 
178F 
2AR513 
LHLD 
STLOC 
~'ES../'lARKIT DOUBLE 
684 
/792 
7£ 
NOV 
A ..1'1 
PEFINED 
685 
1793 E67F 
ANI 
o7F 
686 
1795 17 
NOV 
1'1.' 
A 
AND 
REPLACE 
IT 
687 
1796 
C39FI7 
J/'IP 
PIE 
688 
1799 2ABCI8 
PID 
LHLD 
PITNP 
689 
179C 
CD711 I 
CRLL 
S~'NENT 
ENTER 
S'T'NBOL IN 
TABLE 
690 
179F 
3A84t17 
PIE 
LDA 
CLASS 
691 
17A2 
FEFF 
CPI 
oFF 
692 
17A4 
CAB218 
JEO 
PI INC4 
693 
I?R7 
E67F 
RNI 
o7F 
694 
17A9 
CACtI17 
JZ 
PICtt 
695 
17AC 
CDD918 
CALL 
CKZ80 
CHECK 
FOR 
RNB I GUOUS 
INST" S 
696 
17RF 
1600 
NVI 
D ..B 
697 
1781 
21BF/:3 
LXI 
H ..PI L T8L-1 
ADDRESS 
OF 
LENGTH 
TABLE 
698 
17B4 
19 
DAD 
D 
699 
17B5 
5E 
NOV 
E ../'/ 
?f.tO 
17B6 
2AB8/8 
PISUN 
LHLD 
ILC 
GET 
OLD 
LOCATION 
COUNTER 
701 
1789 
19 
DAD 
D 
RDD 
NHI 
LENGTH 


?f32 
17BR 
228818 
SHLD 
ILC 
RESTORE 
LOCATION 
COUNTER 
?t't3 
178P C32117 
J/'IP 
PIB 
AND 
GET 
NEXT 
INSTRUCTION 
704 
.'/< 
7t15 
.'/< 
CLASS 
0 PROCESSOR 
706 
.'/< 
78(' 
17CB 
IIRBtt7 
PICtt 
LXI 
D ..OPNDF 


708 
17C3 
3A8507 
LDA 
SKH 
GET 
INSTRUCTION 
SKELETON 
709 
17C6 
FEO('1 
CPI 
0 
?It! 17C8 
CAOEI8 
JEl~ 
PIORG 
ORG 
711 
17CB 
FEOI 
CPI 
I 
7/2 
17CD 
CA0518 
JEO 
HANGUP 
713 
17DO 
FE02 
CPI 
2 
?l4 
17D2 
CAACI8 
JEO 
PIINC3 
ARS 
7/5 
17D5 
FEIJ3 
CPI 
3 
?l6 
17D7 
CA271B 
JEO 
PI TITl 
TITl 
7/7 
17DA 
FE04 
CPI 
4 
7/8 
17DC 
CA2117 
JEO 
PIB 
UNL 
7J9 
17DF 
FEft5 
CPI 
5 
72tl 
17EI 
CA2117 
JEO 
PIB 
LST 
721 
17E4 
FE136 
CPI 
6 
122 
17£6 CA6DI8 
JEO 
PIOTA 
DATA 
723 
1?£9 FE137 
CPI 
7' 
724 
17E8 
CA211? 
JEO 
PIB 
EOU 


725 
17EE 
FEft8 
CPI 
S' 


726 
17Ftl CA5118 
JEa 
PIASC 
ASC 
727 
17F3 
FEI3:~ 
CPI 
:~ 
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I?F5 
CA3FI8 
lElJ 
PIRES 
RES 
17F8 FEOA 
CPI 
1& 
17FA CA2117 
lEa 
PIB 
REN 
17FD FEOB 
CPI 
/I 
17FF CAA618 
lEa 
PIINC2 
DBL 
/8t12 
C3B2'8 
lNP 
PI INC4 
JUST 
IN 
CASE 
... 


1805 3A9FI3 
HANG UP 
LDA 
INFLAG 
TEST 
FOR 
TAPE 
INPUT 


1803 B7 
ORA 
A 
1809 CB 
RZ 
NENoR~' INPUT 
18BA CD7401 
CALL 
SB 
WAIT 
FOR 
SPACE 
BAR 
130D C9 
RET 


?28 
729 
730 
73/ 


734 
735 
136 


739 
740 
741 
742 
180£ CDOFI5 
743 
1811 FEA& 
744 
1813 CAIBI8 
745 
1816 FE8D 
746 
/818 
C22' /? 
747 
1818 CDE51F 
748 
181E DA2EI9 
149 
/82' 2288/8 
;::'SB /824 
C32/ 
I? 
751 


753 
154 /827 0626 
755 '829 
2IABO? 


756 
182C 
IIC813 
757 
/82F 7E 
758 
183ft 
'2 
759 
/831 23 
76tl /832 
'3 
761 
1833 
05 


?62 /834 
C22FI8 


763 
1837 3EFF 
764 /839 
328£18 
765 
183C 
C321/7 


'?66 
767 
768 
769 
183F CD8FI5 
77t1 
1842 
78 
771 
1843 FE82 


772 
/845 
FA2E'9 
773 
/848 FE26 
774 
184A D22EI9 
775 
184D EB 


776 
184E C386/7 
777 
778 
179 
780 
1851 CDOFI5 
781 
1854 FEA0 
782 
1856 CA5EI8 
783 1359 FE8D 
784 '858 
C2AOIS 
785 
18SE 
7:3 


** oRG 
PROCESSOR 
*PIORG 
CALL 
FANL ~'Z 
GET 
OPERAND 
IIALUE 
CPI 
NUST 
END 
IN BLANK 
lEa 
PIoRG2 


CP I 
..8D 
OR CARR I AGE 
RETURN 
lNE 
PIB 
IGNORE 
ORG 
PIORG2 
CALL 
TCHKI 
lC 
PIERFL 
SHLD 
ILC 
SET 
NEN 
LOCATION 
COUNTER 
JNP 
PI8 
GET 
NEXT 
INSTRUCTION 
** TITL 
PROCESSOR 
*PITITL 
N\/l 
8..38 
NOliE TITLE 
FIELD 
LXI 
H.,OPNDF 
LXI 
D.. TITLE 
PITTL2 
NOV 
A ..N 
STAX 
D 
INX 
H 
INK 
D 
DCR 
B 
lNZ 
PI TTL2 
NIII 
A.o-/ 


STA 
TLFLRG 
ll1P 
PIB 
** RES 
PROCESSOR 
*PIRES 
CALL 
FANLYZ 
GET 
BLOCK 
SIZE 
Nt1lo' 
A.,B 
CHECK 
FIELD 
n'PE 
CPI 
2 


l( 
PIERFL 
CPI 
32 
lGE 
PIERFL 
PIRES2 
XCHG 
ll1P 
PISUN 


** RSC 
PROCESSOR 


*PIRSC 
CALL 
FANL ~'Z 


CP I 
NUST 
END 
IN 
BLANK 


lElJ 
PIRSC2 
CPI 
"8D 
OR CRRRIAGE 
RETURN 
lNE 
PIINCI 
PI RSC2 
110\/ 
A ..B 
CHECK 
TYPE 


PAGE 
49 
Z8i.:.1 
RESIDENT 
EDlTOR/AS5ENBLER 


786 
185F 
FE20 
CPI 
32 
787 
1861 
C2AOl8 
JNE 
PIINCI 
7'88 
1864 
?D 
NOll 
A,L 
789 
186'5 FE25 
CPI 
37 
19t1 /867 
D2AOl8 
JGE 
PIINCI 
191 
186A 
C34DI8 
JNP 
PIRE52 
792 
.'I< 
193 
.'I< DATA 
PROCESSOR 
194 
.'I< 
7'95 186D 
21 OOt~O 
PIDTA 
LXI 
H ..O 
796 
/8?f:.l 22BC/8 
SHLD 
Pimp 
797 
IB7'3 GOOF 15 
PIDTAI 
CALL 
FANL~'Z 
?9S 
/876 
DA9AI8 
JC 
PIDTR3 
799 
/879 
4F 
NOli 
C,A 
8tW 
181A 
78 
NLf\l 
A,B 
CHECK 
n'PE 
FIRST 
BOI 
187'B FE02 
CPI 
2 
8t12 IS?!> 
FA9AI8 
J( 
P WTA3 
803 
1880 
FE20 
CPI 
32 
8t14 /882 OA8818 
JAL 
PIDTff2 
805 
1885 
1D 
NOli 
A,L 
8t16 /886 
FEOI 
CPI 
I 
CHECK 
CORRECT 
FIELD 
LENGTH 
8t17 
/888 
C29AI8 
JNE 
PIDTA3 
StlS 
/888 
E5 
PIDTA2 
PUSH 
H 
S09 
188C 
2ABCI8 
LHLD 
PITNP 
810 
188F 23 
INX 
H 
INCRENENT 
LENGTH 
S/I 
189tl 22BCI8 
SHLD 
P J TNP 
8/2 
/893 EI 
POP 
H 
SI3 
IS94 
7'9 
NO\-' 
A ..C 


814 
1895 
FEAC 
CPI 


..., 
LAST 
ITEN) 
815 
/897 
CAnl8 
JEa 
PIDTAI 
816 
189A 
2A8CI8 
PIDTR3 
LHLD 
Pimp 
8/7 
189D 
C34D18 
JNP 
PIRES2 
818 
.'I< 


S/9 
ISAO 
210100 
PI INC I 
LXI 
H, I 
82tl 
18A3 
C34018 
JNP 
PIRES2 
821 
ISA6 
2102t~0 
PI INe2 
LXI 
H·:> 
.'':'' 


822 
18A9 
C34DI8 
JNP 
PIRES2 
823 
1SAC 
21B300 
PI INC3 
LXI 
H.3 
824 
18AF 
[:34018 
JNP 
PIRES2 
825 
18B2 
21B400 
PI INC4 
LXI 
H ..4 
826 
1885 C34DI8 
JNP 
PIRES2 
8·)"? 
ISBS 
OOt~O 
ILl' 
DBL 
0 
~, 
828 
188R 
0000 
OPGVAL 
DBL 
0 
829 
188C 
0001.1 
PI TMP 
DBL 
0 
:930 
188E 
101000 
TLFLAG 
OBL 
0 
S31 
.'I< 


832 
.'I< 
INSTPUCTION 
LENGTH 
TABLE 
833 
.'I< 


834 
835 
8080 
INSTRUCTION 
n'PES 
836 
83? 
18W 
tll 
PILT8L 
DATA 
838 
18CI 
01 
OATA 
2 
S39 
18C2 
02 
DATA 
2 
3 
840 
ISC3 
03 
DATA 
3 
4 
841 
18C4 
B3 
DATA 
3 
~~, 
842 
18C5 
01 
DATA 
6 
S43 
18C6 
01 
DATA 
7' 


396 


844 
IBC? &2 
845 
18C8 
E12 
846 
18C9 
01 
847 
848 
849 
850 
18CA 
03 
851 
18C8 
04 
852 
18ce 
tll 
853 
18eL> E12 
854 
18CE IH 
855 
18CF 
E14 
856 
18DB 
02 
857 
/8D/ 
82 
858 
1802 82 
859 
1803 
02 
860 
1804 
02 
861 
1805 
fJ4 
862 
1806 
04 
863 
18D7 
02 
864 
18D8 
t12 
865 
866 
867 
868 
869 
8?tl 
87/ 
872 
18D9 E61F 
873 
180B 
5F 
814 
18DC 
FEf.15 
875 
18DE 
C2FAI8 
876 
18EI 
3AAB07 
877 
18E4 
FED8 
878 
18E6 
CAFOIS 
879 
18E9 
FEI>9 
880 
18E8 
CAFOl8 
881 
18EE 
7B 
882 
18EF 
C9 
883 
18FO 
IEOF 
884 
18F2 
3E21 
885 
18F4 
328587 
886 
18F7 
C3EEI8 
887 
18FA 
FEl~6 
888 
18FC 
CEI 
889 
18FD 
3A85l~7 
898 
190tl FEt13 
891 
1982 
CAI419 
892 
1905 
FEElS 
893 
1907 
CA1419 
894 
198A 
FEC5 
895 
198C 
CAI419 
896 
19E1F FECI 
897 
1911 C2EEI8 
898 
1914 
3ARBO? 
899 
1917 FEC>8 
908 
1919 CA21 19 
901 
191C 
FE09 


OATA 
2 
DATA 
2 
DATA 


DRTA 
3 
DATA 
4 
DATA 
1 
DATA 
2 
DATA 
4 
ORTA 
4 
DATA 
2 
DATA 
2 
DATR 
2 
ORTA 
2 
DATA 
2 
DATA 
4 
DRTA 
4 
DATA 
2 
DRTR 
2 


."/< 


."/< CHECK 
FOR 
ANBIGUHIES 
IN 
INSTRUCTION 
H'PES 


."/< 5 AND 
6. 
TYPE 
5 (LXI) 
BECOMES 
TYPE 
F 
IF 
ITS 
* OPERRND 
STRRTS 
WITH 
X OR 
Y. 
TYPE 
6 INSTRUC- 


."/< 
TIONS 
INX, 
DCX, 
PUSH 
AND 
POP 
BECOME 
T~~E 
II 
* IF 
THE 
F I"'ST OPERAND 
CHARACTER 
IS X OR ~'. 


*CK28t1 
ANI 
NOV 
CPI 
JNE 
lOA 
CPI 
JEQ 
CPI 
JEQ 
NOV 
RET 
MVI 
MVI 
STA 
JMP 
CPI 
RNZ 
LDR 
CPI 
JEQ 
CPI 
JEQ 
CPI 
JEl~ 
CPI 
JNE 
LDA 
CPI 
JEl~ 
CPI 


, IF 
E ..A 
5 
CZ6 
OPNDF 
/X.I' 
CKZ2 
'Y'- 
CKZ2 
A,E 


E.- 'F 
R.. '21 
SKEL 
CkZRET 
6 


SKEL 
3 
CZ? 
'B 
CZ7 
'C5 
CZ7 
'CI 
CKZRET 
OPNDF 
/X"" 
CZ8 
'Y' 


CLEAR 
SUPERFLUOUS 
BITS 
SAVE 
T'r'PEIN E 
IS 
1T fiN LXI'? 
NO.. CHECK 
TYPE 
6 
~~S, 
GET 
1ST OPERAND 
CHAR 
CHECK 
FOR 
X OR 
Y 


CHANGE 
TO 280 
LX I X/V 
CHANGE 
INSTRUCTION 
SKELETON 


JNE 
CKZRET 
lOA 
SKEL 
ORI 
:20 
STA 
SKEL 
~WI 
E..'II 
JMP 
CKZRET 


I ERRORS 


LXI 
H ..HE.\' 


CALL 
PRT 
LXI 
H ..PIENSG 
CALL 
PRT 
LDA 
PRFLAG 
ORA 
A 
JZ 
PI8 
LXI 
H ..HEX 


CALL 
LPNT 
LXI 
H..PIENSG 
CALL 
LPNT 
JNP 
PI8 
Ac:r 
p" 


DATA 
:8D 


LXI 
H..HEX 
CALL 
PRT 
LXI 
H..PIOMSG 
CALL 
PRT 
lOA 
PRFLAG 
ORA 
A 
JZ 
PI8 
LXI 
H ..HE.\' 


CALL 
LPNT 
LXI 
H..PHif'lSG 
CALL 
LPNT 
RIP 
PI8 
ASC 
5' 


DATA 
:80 


S'r'N80L·NOT 
El~U 


LXI 
H ..HEX 


CALL 
PRT 
LXI 
H.PIUNSG 
CALL 
PPT 
LDA 
PRFLAG 
ORA 
A 
J2 
PIE 
LXI 
H..HEX 


CALL 
LPNT 
LXI 
H..PIONSG 


CALL 
LPNT 
JNP 
PIE 


902 
191£ C2EEI8 
9lU 
1921 3A8507 
904 
1924 F62t1 
9115 
1926 328507 
9136 1929 
lEI I 
907 
1928 C3EEI8 
9f.18 
9139 
91 t1 
911 
192E 218907 
912 
1931 CD9901 
913 
1934 215019 
914 
1937 CD99f.11 
915 
193A 3AAOl3 
916 
193D 87 
91 7 
193E CA21 17 
918 
1941 218907 
919 
1944 CD6CI4 
92f.1 
1947 215019 
921 
194A CL>6C14 
922 
194D C32117 
923 
1950 AOAOAOAO 
924 
1955 8L> 
925 
926 
1956 218907 
927 
1959 CD9901 
928 
195C 2178/9 
929 
195F c[>99l~1 
930 
1962 3AAOl3 
931 
1965 87 
932 
1966 CA2117 
933 
1969 218907 
934 
196C C06CI4 
935 
196F 217819 
936 
1972 C06CI4 
937 
1975 C321 17 
938 
1978 AOAOAOAO 
939 
1970 8D 
94f.1 
941 
942 
943 
197E 2189137 
944 
1981 C09901 
945 
1984 217819 
946 
1987 C09901 
947 
198A 3AAll/3 
948 
1980 87 
949 
198E CA9FI7 
95t1 
1991 2189f.17 


951 
1994 CD6CI4 
952 /997 2/7819 
953 
199A C06CI4 
954 
199L> C39FI7 


955 
956 
957 
958 
19Rt1 2RRC22 
959 
19R3 23 


.'#> 
* 
PASS 


.'#> 
PIERFL 


.'#> 
* 8RO 
*PILERR 


** CONI/ERT LINE 
NUN8ER 


.'#> 
CNI/LNO 
LHLO 
P2LNO 
INX 
H 


PRGE 
~:., 
Z8ft 
RESIDENT 
EOITOR/ASSENBLER 


960 
19A4 
22RC22 
SHLO 
P2LNO 
961 
19A7 
I I 18FC 
LXI 
0 ..-/liOO 
962 
19AR 
CDOE03 
CALL 
CNVOEC 
963 
/9AO 
119CFF 
LXI 
0 ..-100 
964 
19BO 
COOE83 
CALL 
CN\lDEC 
965 
19B3 
328987 
STR 
HEX 


966 
1986 
IIF6FF 
LXI 
0 ..- ft1 
967 
1989 
CVOEt13 
CALL 
CNVOEC 
968 
198C 
J28Rt17 
STA 
HEX+I 
969 
198F 
70 
/'10V 
A ..L 
97f1 
19Ctl F680 
ORI 
'BO 
97/ 
19C2 
328B87 
STA 
HEX+2 
972 
19C5 
C9 
RET 
973 


."#< 
974 


."#< F:ESIDENT 
ASSE/'IBLER 
975 


."#< 


976 
19C6 
210000 
PASS2 
LXI 
H ..O 
977 
19C9 
2288/8 
SHLO 
ILC 
918 
19CC 
22BR/8 
SHLO 
ORG~'AL 
979 
19CF 
22RC22 
SHLO 
P2LNO 
980 
1902 
3E3C 
/'IV 
I 
A ..60 
981 
1904 
CVFI22 
CRLL 
PCHBLT 
982 
1907 
C06801 
P2A 
CALL 
OTCTCC 
983 
19DR 
DAA422 
JC 
RTf10N 
984 
1900 
C03714 
CALL 
FSRCO 
98·5 
19Et1 CDAOl9 
CRLL 
CN Io'LNO 
986 
19E3 
2100110 
LXI 
H ..O 
987 19E6 
22AE22 
SHLO 
ERROFi'S 
988 
19E9 
228022 
SHLO 
OCOOE 
989 
19EC 
228222 
SHLO 
OCOOE+2 
990 
19EF 
22EF22 
SHLO 
RSLNTH 
991 
19F2 
21AOAO 
LXI 
H ..'AliAI] 
992 
19F5 
22£622 
SHLD 
EeA 
993 
19F5 
22E822 
SHLD 
ECA+2 
994 
19FB 
22EA22 
SHLO 
ECA+4 
995 
19FE 
22£C22 
SHLO 
ECA+6 


£196 IAOI 
3A9007 
LOA 
LABEL 
997 
lAIN 
FEAA 
CPI 
/*,- 


998 
1Al16 CA3222 
JHJ 
P2P/<'C 
999 
IA89 
FEAO 
CPI 
litl8 
IAOB 
CA351A 
JE(I 
P28 
liOI 
IAOE 
CDOFI6 
CALL 
SLL8L 
lil12 IAII 
021FIA 
JNC 
PZAIA 
003 
IAI4 
3AAE22 
P2AI 
LDA 
ERRORS 
004 
IAI7 
F6114 
ORI 
SWIBIT 
Oli5 
IAI9 
32AE22 
STR 
ERRORS 
006 
lAIC 
C3351A 
Jf1P 
P28 
087 
IAIF 
219Dli7 
PZA/A 
LXI 
H ..LABEL 
(;IOG' 
JR22 
COBOl I 
CALL 
SRCSTB 
&&9 IR25 
2AA513 
LHLO 
snoc 
&1II IA28 
7£ 
/'1010' A ..N 
Off 
IA29 
87 
ORA 
A 
lll2 
IA2A 
FA35 IA 
IN 
P28 
013 
/A20 
3AAE22 
LOA 
E/<'/<'ORS 
lll4 
IR3l1 F608 
ORI 
NOFBIT 
&15 
IA32 
32AE22 
STR 
ERRORS 
016 
IA35 
3A8407 
P2B 
LOA 
CLRSS 
017 
IA38 
FEFF 
CPI 
'FF 


399 


PRGE 
53 
Z8l~ RESIDENT 
EDITOR/RSSEMBLER 


018 
IRJR 
CRE52 1 
lEQ 
P2BDOP 
1319 IRJL> E61F 
RNI 
:?F 
l~2£1IRJF 
CR5?IR 
JZ 
P2Cl7t 
821 
IR42 
CDD918 
CRLL 
CKZSO 
022 
IR45 
S7 
RDD 
R 
~, 
1323 IR46 
5F 
1'10 
'v' 
E,R 
l'l24 IR4? 
1600 
MVI 
D, II 
825 
IR49 
218318 
LXI 
H,P2JTBL-2 
026 
IR4C 
19 
DRD 
D 
827 
IR4D 
E8 
XCHG 
028 
IR4E 
IR 
LDRX 
[l 
029 IR4F 
6F 
MOV 
LR 
030 
IR50 
13 
INX 
D 
l~31 IR51 
IR 
LDRX 
D 
t.132 
IR52 
6? 
MOll 
H,R 
033 
IR53 
IIRBO? 
LXI 
D.>OPNDF 
OPERRND 
POINTER 
TO D-E 
034 
IR56 
E9 
PCHL 
JUNP 
TO PROCESSOR 
1335 
.'/< 


l136 
'* PSEUDO-OP 
PROCESSOR 
037 
'* 
03S 
IR5? 
IIRB0? 
P2Cll 
LXI 
f>.> OPNOF 
1339 IR5R 
JRS587 
LDR 
SKEL 
040 
IR5D 
FEOO 
CPI 
£1 
OFW 
041 
IR5F 
CRBOIR 
JEQ 
P20RG 
042 
IR62 
FElli 
CPI 
I 
END 
043 
IR64 
CRD71R 
JEQ 
P2END 
l144 IR6? 
FE02 
CPI 
2 
RRS 
045 
IR69 
CRORIR 
JEQ 
P2RRS 
046 
IR6C 
FEf./3 
CPI 
3 
TITL 
1341 IR6E 
CRD719 
JEQ 
P2A 
048 
IR71 
FE04 
CPI 
4 
UNL 
1349 IR73 
CAFOIR 
JEl~ 
P2UNL 
050 
IR76 
FEt15 
CPI 
5 
LST 
1351 IRIS 
CAF71R 
JEl~ 
P2LST 
l152 IR7B 
FE06 
CPI 
6 
PR7R 
053 
IR1D 
CRR91B 
JEQ 
P2DRTR 
854 
IR8B 
FEf./? 
CPI 
7 
EQU 
855 
IR82 
CR9CIR 
JEQ 
P2EQU 
056 
IR85 
FE08 
CPI 
8 
RSC 
1357 IRS7 
CRFRIB 
Jm 
P2RSC 
858 
IRSR 
FE09 
CPI 
9 
RES 
859 
IRSC 
CR3718 
JEQ 
P2RES 
l~60 IR8F 
FEBR 
CPI 
IB 
REN 
061 
IR91 
CR3FIC 
JEQ 
P2REN 
l162 IR94 
FE8B 
CPI 
1/ 
DBL 
863 
IR96 
CR481C 
JEQ 
P2DBL 
l~64 IR99 
C3E52 1 
JMP 
P2BDOP 
JUST 
IN 
CASE ... 


865 
IR9C 
219D07 
P2El~U 
LXI 
H ..LRBEL 
866 
IR9F 
CDBOII 
CRLL 
SRCSTB 
867 
IAR2 D23222 
JNC 
P2PRC 
868 
IRR5 
3RRE22 
LDR 
ERRORS 
869 
IRRS 
F601 
ORI 
UNDFBT 
l~70 IRRR 
32RE22 
5TR 
ERRORS 
1371 IRRD 
C3J222 
JMP 
P2PRC 
872 
'* 
1373 
.'/< ORG 
PROCESSOR 
l174 
.'/< 
875 
IRB8 
CD8FI5 
P20RG 
CRLL 
FRNL'T'Z 
GET 
OPERRNO 


400 


ti76 
IABJ 
FEAft 
CPI 
END 
IN 8LANK 
OR 
C.R. 
O?? 
IA85 
CA8DIA 
JEG 
P20F:G2 
tl?8 
lABS 
FESD 
CPI 
:SD 
879 
IA8A 
C2CCIA 
JNE 
P20RG3 
OS8 
IABD 
COE51F 
P20RG2 
CALL 
TCHKI 
881 
IACO 
DACCIA 
JC 
P20RG3 
882 
IRC3 2288/8 
SHlO 
ILC 
SET 
NEI" LOCATION 
COUNTER 
88J 
IAC6 
CD3C23 
CALL 
OP08JR 
OS4 
IAC9 
C33222 
JI1P 
P2PRC 
085 
IACC 
3AAE22 
P20RG3 
lOA 
ERRORS 
tiS6 IACF 
F6t11 
ORI 
UNDF8T 
ft87 
IADI 
32AE22 
STA 
ERRORS 
t.1SS 
IAD4 
C33222 
JI1P 
P2PRC 
889 
'*' 
t19tl 
'*' END 
PROCESSOR 
t~91 
'*' 
092 
lAD? 
C3F521 
P2END 
JI1P 
P2PRNT 
t't9:' 
'*' 
t194 
'*' ARS 
PROCESSOR 
895 
'*' 
1.196 IAOA 
3H13 
P2ARS 
11~'I 
A,3 
89? 
IADC 
32RF22 
STA 
P2LNTH 
t198 
IADF 
JEt1? 
I1VI 
A ..? 
899 
IAEI 
32B!.122 
STA 
OCODE 
SET 
08JECT 
/tIt'l 
IAE4 
211FIF 
LXI 
H ..'IFIF 
RRR+RRR 
181 
IRE? 
228122 
SHlO 
OCODE+I 
/f.I2 
IREA 
CL>I223 
CRLL 
PCH08J 
/l'l3 
IRED 
C3F52 I 
JI1P 
P2PRNT 
/t14 
'*' 
185 
'*' UNL 
PROCESSOR 
/06 
'*' 
18? 
IAFO 
RF 
P2UNL 
ZRR 
/t18 
IRFI 
32Rtl/3 
P2UNLR 
STR 
PRFLRG 
189 
IAF4 
C3D719 
JI1P 
P2A 
I/O 
'*' 
1/1 
'*' LST 
PROCESSOR 
1/2 
'*' 
1/3 
IFlF? 3RA213 
P2LST 
LDA 
LSTFLG 
1/4 
IAFA 
fECC 
CPI 
·'L·· 


1/5 
IAFC 
C2D?19 
JNE 
P2F1 
1/6 
IRFF 
C3FIIA 
JI1P 
P2UNLA 
I/? 
1882 
C3FIIA 
JI1P 
P2UNLA 
118 
'*' 
1/9 
'*' JUI1P ADDRESS 
TA8LE 
12tl 
'*' 
121 
IB85 
A7IC 
P2JT8L 
D8L 
P2CI 
/22 
IBtl? E61C 
D8L 
P2C2 
123 
18t'l9 
10lD 
D8L 
P2C3 
124 
IBt18 661D 
D8L 
P2C4 
125 IBOD 
C61D 
DBL 
P2C5 
126 
18t'lF2BIE 
D8L 
P2C6 
127 IBI/ 
9?IE 
D8L 
P2C7 
128 
1813 
A21E 
D8L 
P2C8 
129 
1815 
E81E 
D8L 
P2C9 
138 
1817 
IBIF 
D8L 
P2CA 
131 
IBI9 
491F 
DBL 
P2C8 
/32 
IBIB 
8DIF 
DBL 
P2CC 
133 
IBID 
3128 
DBL 
P2CD 


401 


PAGE 
55 
Z80 
RESIDENT 
EDITOR/ASSEM8LER 


/34 
/8/F 
3F28 
D8L 
P2CE 
/35 
/821 
6E28 
D8L 
P2CF 
/36 
1823 
A828 
D8L 
F'2C/8 
/37 
/825 D620 
DBL 
P2CII 
/38 /82? EB20 
DBL 
P2C/2 
139 /829 F520 
D8L 
P2C/3 
/48 
/82B 
FF28 
D8L 
P2C/4 
/4/ 
/B2D 
292/ 
D8L 
P2C/5 
/42 
/B2F 
532/ 
DBL 
F'2C16 
/43 
/B3/ 
8/21 
D8L 
P2CI? 
144 
/B33 
C821 
V8L 
P2CIS 
145 /835 D82/ 
DBL 
P2CI9 
146 
.'#< 
147 
* RES 
PROCESSOR 
148 
.'#< 
/49 
/837 AF 
P2RES 
ZAR 
158 
/838 
J2RR22 
STA 
FCFLAG 
/51 
183B 
CDflF/5 
CALL 
FANL'r'Z 
152 
183E 
4F 
1'10\1 
C.'A 
153 
IB3F 
CDE51F 
CALL 
TCHKI 
154 
1842 VA8218 
JC 
P2RESU 
/55 
1845 22EF22 
SHLD 
R5LNTH 
156 
1848 79 
1'10\1 
A.oC 
157 
1849 FERt! 
CPI 
158 
/848 CA1CIS 
JE(~ 
NOFILL 
/59 
/84E 
FE8D 
CPI 
:SD 
168 
/85t1 CA7CI8 
JEQ 
NOFILL 
161 
1853 FEAC 
CPI 
.' 
.0 .- 


/62 
1855 
C282/8 
JNE 
P2RESU 
163 
1858 CDaF/S 
CALL 
FANL'r'Z 
164 
/85B 
DA9E/B 
JC 
P2RESL 
/65 
185E 
78 
NOlo' 
A.o8 
166 
/85F 
FEt12 
CPI 
2 
167 
1861 FA82/B 
J( 
P2~'ESU 
/68 
IB64 
FE2l'l 
CPI 
32 
/69 
/866 DA73IB 
JAL 
5TFILL 
/1l'l/869 1D 
1'10\1 
A ..L 
171 
/86A 
FEl1l 
CPI 
/ 
172 
186C 
C293 18 
JNE 
P2RSUF 
/73 
IB6F 
3A05/6 
LOR 
LACHAR 
/74 
1812 6F 
/'10 V 
LA 
175 
1873 3EGI 
STFILL 
M'v'I 
A ..1 
116 
1875 32RR22 
STA 
FCFLAG 
177 
1818 10 
NOV 
A.oL 
118 
1819 32RB22 
STA 
FLCHAR 
119 
181C 
CD8D23 
NOF ILL 
CALL 
PCHRE5 
188 
IB7F C3F52 I 
JNP 
P2F'RNT 
181 /882 2/8t100 
P2F:E5U 
LXI 
Hog 
/82 
1885 22EF22 
SHLfi 
RSLNTH 
183 /888 3AAE22 
LOA 
ERRORS 
184 
IB8B 
F6t11 
ORI 
UNDFBT 
/85 
1880 
32RE22 
STR 
ERRORS 
186 
1898 CJF52 I 
J/'IP 
F'2PRNT 
/81 
/893 JAAE22 
P2R5UF 
LOA 
ERRORS 
/88 
1896 F6fJI 
ORI 
UNDFBT 
/89 
IB98 
32RE22 
STA 
ERRORS 
19t1 IB9B 
C31CIB 
J/'IP 
NOFILL 
191 
189E 
3ARE22 
P2RESL 
LDA 
ERRORS 
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CLEAR 
FILL 
CHRR. 
FLAG 


SAVE 
TERNINATOf: 


SME 
LENGTH 


NAS 
THERE 
A FILL 
CHARACTER? 


GET 
FILL 
CHARACTER 
LENGTH 
ERROR 
CHECV 
T'r'PE 


PRGE 
56 
ZS8 
RESIDENT 
EDITOR/RSSENBLER 


192 
18RI 
F682 
ORI 
LNTHBT 
193 
18R3 
32RE22 
STR 
ERRORS 
194 
IBR6 
C31CIB 
JNP 
NOFILL 
195 
* 
196 
* ERROR 
BIT 
SPECIFICRTIONS 
191 
* 
198 
UNDFBT 
EQU 
199 
LNTH8T 
EQU 
2 
28tf 
S~'NBIT 
Eau 
4 
281 
NDFBIT 
EQU 
8 
292 
REBIT 
ECW 
16 
283 
OPBIT 
EQU 
3·~ 
'- 
284 
RDRBIT 
E@ 
64 
285 
DSPBIT 
EQU 
128 
286 
* 
287 
* "DRTR" 
PROCESSOR 
288 
* 
289 
18R9 
218822 
. 
P2DRTR 
LXI 
H,OCOOE 
218 
18RC 
22E822 
SHLD 
P20PTR 
211 
18RF 
CD8FI5 
P2DTR8 
CRLL 
FANL ~'Z 
2/2 
1882 
DRF218 
JC 
P20TR4 
LENGTH 
ERROR 
213 
1885 
4F 
NOV 
LR 
214 
18B6 
18 
/'10 V 
A,B 
215 
1881 
FE82 
CPI 
2 
CHECK 
n'PE 
216 
IB89 
FRE11B 
J( 
P20TA3 
~/1 
18BC 
FE28 
CPI 
32 
•.18 
IB8E 
DRCBIB 
JRL 
P2L>TR2 
219 
18CI 
10 
NOV 
A,L 
228 
IBC2 
FE81 
CPI 
I 
RSCII, 
/'lUSTBE 
I 
221 
IBC4 
C2F21B 
JNE 
P2DTA4 
222 
IBC? 
3R0516 
LDR 
LRCHAR 
223 
18CR 
6F 
NOV 
LR 
224 
IBCB 
3RRF22 
P2DTR2 
LDA 
P2LNTH 
225 
IBCE 3C 
INR 
R 
226 
IBCF 
32AF22 
STR 
P2LNTH 
227 
IBD2 
1D 
1'I0V 
R ..L 
228 
IBD3 
2RE822 
LHlO 
P20PTR 
229 
IBD6 
77 
NOV 
/'I,R 
238 
IB0123 
INX 
H 
231 
18D8 
22E822 
SHlO 
P20PTR 
232 
IB08 
19 
1'10 
V 
A ..C 
233 
18DC 
FERC 
CPI 
, 
.' 
/ 
LRST 
ONE? 


234 
IBDE 
CRAFI8 
JEa 
P2DTR8 
235 
18EI 
CD 1223 
P20TNO 
CRLL 
PCH08J 
236 18E4 
C3F52 1 
JNP 
P2PRNT 
237 
18E1 
3RAE22 
P2DTA3 
LDR 
ERRORS 
238 
IBER 
F681 
ORI 
UNDFBT 
239 
IBEC 
32RE22 
P2DC 
STR 
ERRORS 
248 IBEF 
C3EI18 
J/'IP 
P2DTND 
241 
IBF2 
3RAE22 
P2DTR4 
lOR 
ERRORS 
242 
IBF5 F6tf2 
ORI 
LNTHBT 
243 
IBF? 
C3ECIB 
J/'IP 
P2DC 
244 
* 
245 
* 
"RSC" 
PROCESSOR 
246 
* 
247 
IBFA 
3E131 
P2RSC 
/'IV 
I 
R,I 
248 
IBFC 
32AF22 
STR 
P2LNTH 
249 IBFF 
CDOFIS 
CRLL 
FRNL'r'Z 
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PRGE 
C"? 
Z8t.1 RESIDENT 
ED ITO"'/R55EN8LER 
-" 


258 
IC82 
4F 
NlW 
CR 
251 
IC83 
78 
NOll 
R ..8 
252 
ICl'l4FE28 
CPI 
32 
253 
IC86 
C22CIC 
JNE 
P2RSC4 
254 
IC89 
?V 
NOll 
R ..L 
255 
IC8R 8? 
ORR 
R 
25"6 
IC88 
CRJ?IC 
JZ 
P2RSC5 
257 
IC8E 
FE25 
CPI 
37 
258 
IClt; 02J?lC 
JGE 
P2RSC5 
259 
ICI3 
1IRB8? 
LXI 
V ..OPNVF 
268 
IC/6 
IJ 
INX 
V 
SKIP 
RPOSTROPHE 
261 
ICI? 
21Bt;22 
LXI 
H ..OCOVE 
262 
ICIR 
47 
NOll 
fl..R 
263 
ICIB 
32AF22 
STR 
P2LNTH 
SA~'E LENGTH 
264 
ICIE 
IR 
P2RSC2 
LDRX 
D 
TRANSMIT 
STRING 
265 
ICIF 
?? 
NOll 
N ..A 
266 
IC20 
IJ 
INX 
V 
267 
IC21 
23 
INX 
H 
268 
IC22 
05 
DCR 
B 
269 
IC2J 
C21EIC 
JNZ 
P2RSC2 
27t1 IC26 
CDI223 
P2RSCJ 
CALL 
PCHOBJ 
27/ 
IC29 
C3F52 1 
JI'IP 
P2PRNT 
':'I'?~ IC2C 
3RRE22 
P2RSC4 
lOR 
ERRoPS 
•...... 
273 
IC2F 
F601 
ORl 
UNDFBT 
274 
ICJI 
32RE22 
P2R2 
STR 
ERRORS 
275 
ICJ4 
C3261C 
JMP 
P2ASC3 
2?6 
leJ? 
JAAE22 
P2RSC5 
lOA 
ERF,'OF:S 
27? 
IC3A 
F6tl2 
ORI 
LNTHBT 
278 
IC3C 
C3JIIC 
JI1P 
P2R2 
279 
."/< 
280 
."/< 
"REN" 
PROCESSOF,' 
281 
."/< 
282 
IC3F 
2 1AOAO 
F'2REN 
LXI 
H .."AOAO 
283 
IC42 
22ASB7 
SHlO 
NNEN 
BLANK 
OUT 
I1!~EMONIC 
284 
IC45 
22R7t17 
SHlO 
NNEM+2 
285 
IC48 
C33222 
JMP 
P2PRC 
286 
."/< 
287 
."/< 
"VBL" 
PROCESSOR 
288 
."/< 
289 
IC48 
JE02 
P2V8L 
NIlI 
A 
.~ 
.'':'" 


29t1 
IC4V 
32RF22 
STR 
P2LNTH 
SET 
LENGTH 
291 
IC513 CDOFI5 
CRLL 
FRNL'r'Z 
292 
IC53 
4F 
NOli 
C.'A 
293 
IC54 
78 
Mall 
R ..8 
294 
IC55 
FE02 
CPI 
2 
295 
IC57 
FA151C 
J( 
P2DBLJ 
296 
IC5A 
FE20 
CPI 
32 
297 
IC5C 
C26CIC 
JNE 
P2DBL2 
298 
IC5F 
1D 
NOll 
A ..L 
299 
IC60 
FEOJ 
CPI 
-' 
30t; IC62 
D2831C 
JGE 
F'2DBL5 
301 
IC65 
87 
ORA 
A 
382 
IC66 
CA8JIC 
JZ 
P2V8L5 
383 
IC69 
2RD516 
LHLD 
LACHAR 
304 
IC6C 
22Bt122 
P2DBL2 
SHLD 
oCoDE 
305 
IC6F 
CDI223 
CALL 
PCHOBJ 
306 
1Ci'2 CJF52 1 
JMP 
P2PRNT 
J07 
IC75 
JAAE22 
P2DBL3 
LOA 
ERRORS 
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308 
IC78 
F601 
ORI 
UNOFBT 
3&9 IC?A 
32AE22 
P2DBL4 
STA 
ERRORS 
310 
IC7D 
21e1OOO 
LXI 
H ..0 
311 IC80 
C36CIC 
JMP 
P2D6'L2 
3/2 
IC83 
3AAE22 
P20BL5 
LOA 
ERRORS 
313 IC86 
F602 
ORI 
LNTHBT 
314 
I CBS 
CJ?AIC 
JMP 
P2DBL4 
315 
'* 
316 
* SEARCH 
SINGLE 
REGISTER 
FILE 
317 
'* 
318 IC8B 
0608 
sRF 
1'1\0'1B ..8 
319 IC80 
219FIC 
LXI 
H ..SRFILE 
320 
ICgel BE 
sRFI 
CMP 
M 
321 IC91 
CR9BIC 
JHI 
SRF2 


322 
IC94 
23 
INK 
H 
323 IC95 
l~5 
OCR 
6' 


324 IC96 
(:2901C 
JNZ 
SRFI 
325 IC99 
37 
STC 
CARR'T'ON 
FOR 
NO 
HIT 
326 
IC9A 
C9 
RET 


':1.:)"" 
IC9B 
l~5 
SRF2 
OCR 
B 
~.., 
328 
IC9C 
78 
MO\o' 
A,B 
329 
IC90 
B? 
R5C 
CLEAR 
CRRR~' 
330 
IC9E 
C9 
RET 
331 IC9F 
CICOCl~C8 
SRFILE 
ASC 
'RMLHEOCB' 


332 
* 
333 
'* TYPE 
I PROCESSOR 
334 
* ARITHMETIC/LOGICAL 


335 
'* 
336 ICA? 
3EOI 
P2CI 
M\o'I 
A ..1 
337 IGA9 
32RF22 
STR 
P2LNTH 
338 
ICAC 
IA 
LORK 
0 
339 ICRO 
COSBIC 
CRLL 
SRF 
GET 
REGISTEI" 
SPEC 
340 
ICBO 
DAOBIC 
JC 
P2CIC 
341 IC83 
F5 
PUSH 
PSW 
342 ICB4 
3A85e17 
LOA 
SKEL 
CHECK 
FOR INR/OCR 
343 IC8? 
FE06 
CPI 
6 
344 ICB9 
D2CIIC 
JGE 
PIC2 
345 
ICBC 
78 
/'10\0'R ..B 
INR 
OR 
DCR ../'10\o'E 
REG. 


346 ICBO 
R? 
AOO 
A 
~, 


34? ICBE 
87 
ROD 
A 
348 ICBF 
R7 
AOO 
A 
.." 
349 ICW 
4? 
/'10\0'B,R 
350 
ICCI 
FI 
PIC2 
POP 
PSW 
351 ICC2 
13 
INK 
D 
352 ICC3 
IA 
WAX 
D 
353 
ICC4 
FERO 
CPI 
354 ICC6 
CACEIC 
JEll 
P2CIR 
355 ICC9 
FE80 
CPI 
'SD 
356 ICCB 
C2DBIC 
JNE 
P2CIC 


35? ICCE 
3AS50? 
P2CIA 
LDR 
SKEL 
358 
ICDI 
8el 
ORA 
B 
359 
ICD2 
328&22 
P2CIRR 
STA 
OCODE 
3613 ICD5 
CO 1223 
P2CIB 
CALL 
PCHOBJ 
361 
ICD8 
CJF52 
1 
J/'1P 
P2PRNT 
362 
ICDB 
3AAE22 
P2CIC 
LDA 
ERRORS 
363 ICDE 
F61& 
ORI 
REBIT 
364 1CEO 
32RE22 
sTA 
ERRORS 
365 
Icn 
C3D51C 
JMP 
P2CIB 
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PAGE 
59 
Z80 
RES Il>ENT EDITOR/ASSEMBLER 


366 
"* 
367 
"* 
T'r'PE2 PROCESSOR 
368 
"* /'101/ 
369 
"* 
3?t1 ICE6 
3EOI 
P2C2 
MI/I 
A, I 
37/ 
ICE8 
32RF22 
STA 
P2LNTH 
372 
ICEB 
IA 
LOAX' 
0 
373 
ICEe 
CD8BIC 
CALL 
SRF 
374 
ICEF 
DADBIC 
JC 
P2CIC 
375 
ICF2 
R7 
ADD 
A 
~, 
37'6 
ICF3 
87 
ADD 
A 
~. 
377 
ICF4 
87 
ADD 
R 
~, , 
378 
ICF5 
4F 
MOl/ 
c..A 
379 
ICF6 
13 
INX 
0 
38tl ICF? 
IA 
LOAX' 
0 
381 
ICF8 
13 
INX 
0 
382 
ICF9 
FERC 
CPI 
" .' 


/ 
/'lUSTfiE COMMA 
383 
ICFB 
C2D81C 
JNE 
P2CIC 
384 
ICFE 
IA 
LOAX' 
0 
CHECK 
SECOND 
REGISTER 
385 
ICFF 
CD8BIC 
CRLL 
SRF 
386 
1002 
DADBIC 
JC 
P2CIC 
38? 
1085 
81 
ORA 
C 
/'IERGE REG. 
SPECS 
388 
ID136 FE36 
CPI 
@66 
M ..M 
FORBIDDEN 
389 
1088 
CADBIC 
JHI 
P2CIC 
39tl IDI3B F6413 
ORI 
'413 
MERGE 
OPCOOE 
FOR 
MO'v' 
391 
10&D 
C3D21C 
JNP 
P2CIAA 
392 
"* 
393 
"* T'r'PE3 PROCESSOR 
394 
"* M'v'I 
395 
"* 
396 
/[.> 1tl3E02 
P2C3 
MIlI 
R ..2 
397 
1012 
32AF22 
STR 
P2LNTH 


398 
1015 
IA 
LORX' 
0 
399 
IPI6 
13 
INX 
D 
4tlf.l 
{017 
C'D881C 
CALL 
SRF 
401 
IPIA 
DADBIC 
JC 
P2CIC 
4t12 IDW 
S7 
ADO 
A 
483 
IP/£ 
R7 
RDD 
R 
~, 
4t14 IDIF 
~7 
ADD 
A 
~, 
40:; ID20 
F6f36 
ORI 
6 
MERGE 
14ITH 
N'v'ISKELETON 
406 
ID22 
328t122 
STR 
OCODE 
4117 ID25 
IA 
LOAX 
D 
408 
ID26 
FEAC 
CPI 


,.' 


4&9 
/f.l28 C2DBIC 
JNE 
P2CIC 
410 
ID2B 
13 
INX 
D 
411 
ID2C 
CD8FI5 
CRLL 
FANL'r'Z 
GET 
I1'1MEf>I 
ATE 
OPERAND 
412 
ID2F 
DA:511D 
JC 
P2C3B 
413 
ID32 
78 
MOil 
R ..B 
414 
1033 
FEfJ2 
CPI 
2 
CHECK 
T'r'PE 
415 
ID305 FA:5EID 
J( 
P2C3D 
4/6 
ID38 
FE20 
CPI 
'p 
-'- 
417 
ID3A 
OA471D 
JAL 
P2C3A 
4/8 
ID3D 
1D 
MOil 
A,L 
419 
ID3E 
FWI 
CPI 
1 
42f/ ID40 
C2:5110 
JNE 
P2C3B 
421 
ID43 
3AD516 
LDA 
LACHAR 
422 
/046 
6F 
MOv' 
LA 
423 
1047 
7D 
P2C3A 
NOll 
A,L 


406 


/D48 
328/22 
STR 
OCODE+/ 
SET 
IMMEDIRTE 
OPERRND 
/048 
CD/223 
CRLL 
PCH08J 
/D4E 
C3FS2/ 
JMP 
P2PRNT 
/DS/ 
3AAE22 
P2C38 
LDA 
ERRORS 
/D54 
F6f.l2 
ORI 
LNTHBT 
ID56 
32RE22 
P2C3C 
STA 
ERRORS 
/D59 
2Ef.lf.l 
Wv'I 
Lf.l 
/D58 
C34710 
JMP 
P2C3A 
/DSE 
3RRE22 
P2C3D 
LDA 
ERRORS 
/D6/ 
F6f.l/ 
ORI 
UNDFBT 
ID63 
C356/0 
JMP 
P2C3C 


424 
42S 
426 
427 
428 
429 
43f.l 
43/ 
432 
433 
434 
435 
436 
437 
438 
439 
/D66 
3Ef.l3 
440 
1068 
32AF22 
441 
ID68 
CD8FI5 
442 
ID6E 
CDESIF 
443 
ID11 
DA83/D 
444 
/D74 
3A8Sf.l7 
44S 
ID77 
32B822 
446 
fD7R 22B/22 
447 
1070 
CD/223 
448 
ID8f.lC3FS21 
449 
1083 
3AAE22 
4Sf.l 
ID86 F6f.ll 
451 
ID88 
32RE22 
452 
ID88 
C3701[.> 
4S:, 
4::;4 
455 
456 
457 
458 
459 
46t1 
46 I ID8E 
8680 
462 
1D:=?f.l 
FEG2 
463 
ID92 
CAREIV 
464 
ID95 
f.l4 
465 
1096 
FEC4 
466 
ID98 
CAAE 10 
467 
ID98 
l~4 
468 
109C 
FEC8 
469 
ID9E 
CAREIO 
470 
IDAI 
04 
. 


47/ 
IOR2 
FED3 
472 
IDA4 
C2811D 
473 
IDA7 
13 
4;'4 !DA8 
IA 
475 
IOR9 
FEDf.l 
416 
IDAB 
C2C41D 
477 
IDAE 
78 
478 
lOAF 
B7 


47:=? 
lOBO 
C9 
481:1 
lOB / FEDt1 
481 
IOB3 
C2C41D 


'"'" TYPE 
4 PROCESSOR 
'" MEMORY 
REFERENCE 
'"P2C4 
Mill 
STA 
CALL 
CALL 
JC 
LDA 
STA 
SHLD 
CALL 
JMP 
LDA 
OFI 
STA 
RIP 


A.,J 
P2LNTH 
FANL~'Z 
TCHK/ 
P2C4B 
SKEL 
OCODE 
OCODE+/ 
PCHOBJ 
P2PRNT 
EFRORS 
UNOFBT 
ERRORS 
P2C4A 
'"'" SEARCH 
FOR 
REGISTER 
PAIR. 
THIS 
SEARCH 


'" DEPENDS 
ON 
ILLEGRL 
REGISTER 
BEING 


'" PRE V IOUSL Y EXCLUDED. 
'" RETURN 
I.JITHCARR'r' OFF 
IF R.P. 
FOUND .."'ESULT 


'" IN 
A 
- t1 FOF: B.. / FOR 
[.>., 
2 FOR 
H.. 3 FOR 
SP/PSbl 


'" 
.'/0' 
SDRF 
M\II 
CPI 
JEP 
INR 
CPI 
JEl~ 
INR 
CPI 
JEQ 
INR 
CPI 
JNE 
IN.'>\' 
LDA.'; 
CPI 
JNE 
MOV 
RSC 
RET 
CPI 
JNE 


8,,0 


''S'" 
SDRFD 
8 
'D' 
SDRFD 
B 
"H" 
SDRFD 
B 


SDRFB 
o 
D 
'P' 
SDRFC 
R ..8 


PAGE 
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Z80 
RESIDENT 
ED ITOR,·'ASSENBLER 


482 
IDB6 
13 
INX 
D 
483 IDB7 
IA 
LOA,x; 0 
484 IDB8 
FED3 
CPI 
""5'" 


485 IDBA 
C2C41D 
JNE 
SDRFC 
486 IDBD 
13 
INX 
0 
487 lOBE 
IA 
LDAX 
0 
488 
10BF 
FEO;:' 
CPI 
'1,1" 


489 lOCI 
CAAEID 
JEQ 
SORFD 
490 
IDC4 
?"" 
SDRFC 
STC 
- , 
491 IDC5 
C9 
RET 
492 


.-/< 
493 


.-/< 
T'r'PE5 PROCESSOR 
494 
.-/< LXI 
495 


.-/< 
496 IDC6 
3E03 
P2C5 
/'1VI 
A.,3 
497 IDC8 
32AF22 
STA 
P2LNTH 
498 IDCB 
IA 
LDAX 
D 
499 IDCC 
FEDO 
CPI 
'P' 
EXCLUDE 
PSU 
5€W 
IDCE 
CAtlBIE 
JEQ 
P2C5C 
501 
1001 
CD8EI0 
CRLL 
SDRF 
502 
1l>D4 DAOBIE 
JC 
P2C5C 
503 
1007 
87 
ADD 
A 
504 
1008 
87 
AOD 
A 
585 IDD9 
87 
ADO 
A 
506 
IDDA 8? 
ADD 
A 
507 
IDDB 3C 
INR 
A 
SET 
LOU 
BIT 
FOR 
OPCODE 
508 
IDDC 
328822 
STA 
OCODE 
589 
IDOF 
13 
INX 
D 
518 IDHl 
IA 
LDAX 
0 
5/1 
IDEI 
FEAC 
CPI 
, 


.' , 


512 IDB 
C2161E 
JNE 
P2C5E 
513 IDE6 
13 
INX 
0 
514 IDE? 
CD8FI5 
CALL 
FANL'r'Z 
515 IDEA 
78 
/'10\1 
A,B 
516 IDEB 
FE132 
CPI 
2 
517 
IDEO 
FRI61E 
J< 
P2C5E 
518 IDFl1 FE211 
CPI 
32 
519 IDF2 
C2821E 
JNE 
P2C5RA 
52tlIDF5 
?D 
1'101/ 
A ..L 
521 IDF6 
FE83 
CPI 
3 
522 
IDF8 
D2231E 
JGE 
P2C5F 
523 
IDFB 
B7 
ORA 
A 
524 IDFC 
CA231E 
JZ 
P2C5F 
525 
IDFF 
2RD516 
LHLD 
LRCHAR 
526 1£02 228122 
P2C5AA 
SHLD 
OCOD£+I 
5'~?IE85 
CDI223 
P2C5B 
CRLL 
PCHOBJ 
.., 
528 
IE88 
C3F52 1 
JNP 
P2PRNT 
529 
IEOB 
3ARE22 
P2C5C 
LDA 
ERRORS 
538 IE8E 
F61tl 
ORI 
R£BIT 
531 
IE I('I 32AE22 
P2C5D 
STA 
Ef.<'RORS 
532 IEI3 
C3051E 
J/'1P 
P2C5B 
533 
IEI6 
FEFE 
P2C5E 
CPI 
-2 
534 IEI8 
CA231E 
JEQ 
P2C5F 
535 IEIB 
3AAE22 
LDR 
ERRORS 
536 IEIE 
F681 
ORI 
UNDFBT 
537 IE28 
C310lE 
J/'1P 
P2C50 
538 IE23 
3ARE22 
P2C5F 
LDA 
ERRORS 
539 IE26 
F682 
ORI 
LNTHBT 
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540 
1£28 
CJ/OIE 
NIP 
P2C5D 


t;41 
'*' 
542 
'*' 
n'PE 
6 PROCE'ssOR 
543 
'*' LDAX ..5 TAX,·'" 
INX ..DCX.,DAD ... 
·'PUSH.,POP 
544 
'*' 


545 IE28 
3E131 
P2C6 
NV1 
A.,I 
546 IE2D 
32AF22 
sTA 
P2LNTH 
541 
/E313 3AS.5137 
LDA 
SKEL 
54S 
IE33 
87 
ORA 
A 
549 
1£34 
IF 
RAR 
550 
IE35 
DA54 IE 
JC 
P2TPP 
55/ 
1£38 
IA 
lOAX 
D 
lOAX 
OR 
sTAX 


552 
1E39 
0610 
NI/1 
B.,,10 
553 IE38 
FEC4 
cpr 
"D" 


554 IE3D 
CA471E 
JEa 
P2C6A 
555 
/E413 06011 
/'1\11 B ..O 
556 IE42 
FEC2 
CP1 
"'S" 


557 
IE44 
C28BIE 
JNE 
P2C6D 
558 
IE47 
JASSO? 
P2C6A 
LDA 
SkEL 
559 
IE4ft BO 
P2C6AI 
ORA 
B 
560 
/E48 
328022 
P2C6B 
STA 
OCODE 
561 
IE4E 
CDI223 
CALL 
PCHOBJ 
562 IE51 
C3F52 I 
JNP 
P2PRNT 
563 IE54 
3ABS07 
P2TPP 
lOA 
SKEL 
564 1£57 
FECI 
cpr 
'CI 
565 
IE59 
CA821E 
JEO 
P2PP 
566 IE5C 
FEC5 
CP1 
'C5 
567 
IE5E 
CA821E 
JEO 
P2PP 
CHECK 
FOR 
PUSH 
OR 
POP 
568 
IE61 
IA 
LDAX 
D 
NUST 
BE 
IN.\·..OCX 
OR 
DAD 
56~~IE62 
FEDO 
CP1 
",P/ 
EUNINATE 
PSIoJ 
570 
IE64 
CASBIE 
JEO 
P2C6D 
57/ IE67 
CD8EID 
P2PPI 
CALL 
SNi'F 
5"72 
IE6A 
OASSIE 
JC 
P2C60 
573 
IE60 
13 
INX 
0 
574 IE6E 
IA 
lOAX 
D 
575 
IE6F 
FEAO 
CPI 
" 


576 IE71 
CA?9IE 
JEa 
P2C6C 


.577 
IU4 
FESO 
CP1 
:8D 


578 
IU6 
C28BIE 
JNE 
P2C6D 
579 
IE79 
7S' 
P2C6C 
MOV 
A.,B 
58t.1 
IUA 
87 
AOO 
ft 
58/ 
IE78 
R7 
ADD 
A 
~, 
582 
IE7C 
87 
ADD 
ft 
583 
IUO 
0'37 
ADD 
A 
584 
IE7E 
47 
1'101/ 
B ..ft 
585 IE7F 
C34?IE 
J/'IP 
P2C6A 
586 
1£82 
IA 
P2PP 
LDAX 
D 
PUSH 
OR 
POP 
587 
IES3 
FED3 
CP1 
·~S··' 
EUNINATE 
STACK 
POINTER 
588 
IE85 
CA881E 
JEa 
P2C6D 
589 IE88 
C3671E 
JNP 
P2PPI 
590 
IE8S 
3RftE22 
P2C6D 
lOA 
ERRORS 
591 
lESE 
F6 to 
OR1 
RES IT 
592 
IE9fl J2RE22 
STA 
ERI<.·or.:s 
593 IE93 
RF 
ZRR 
594 
IE94 
C3481E 
JNP 
P2C6B 
595 
'*' 


596 
'*' 
7YPE 
? PROCESSOR 
597 
'*' 
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598 
IE97 
3EfJI 
P2C7 
I'WI 
A ..I 


599 
IE99 
32AF22 
STA 
P2LNTH 
6[1fJ IE9C 
3A8507 
LDA 
SKEL 
601 
IE9F 
C34BIE 
RIP 
P2C6B 
6t12 
.'/< 
603 
.'/< 
T'r'PE8 PROCESSOR 
604 
.'/< 
6@5 
IEA2 
JEt12 
P2C8 
Nil I 
A ..2 
606 
IEA4 
32AF22 
5TA 
P2LNTH 
6fJ7 IEA7 
3R8507 
LOR 
5KEL 


6£18 
IEAA 
328822 
5TA 
oCODE 
609 
lEAD 
CDOFI5 
CALL 
FANL~'Z 
6/tl IEBfJ DAE31E 
JC 
P2CSF 
6/1 
IE83 ~.~ 
NOll 
A ..B 
,.,,:0 
6/2 
IE84 
FE02 
CPI 
£:: 
613 
IE86 
FRD71E 
J( 
P2C8D 
614 
IEB9 
FE2fJ 
CPI 
32 
615 
IE88 
CACBIE 
JEI.~ 
P2C88 
616 
IE8E 
D207IE 
JGE 
P2C80 
617 
IECI 
7D 
NOll 
A ..L 
6/8 
IEC2 
328/22 
P2t~SR 
5TA 
OCODE+i 


619 
IEG5 
CD 1223 
CALL 
PCH08J 
620 
IEC8 
C3F52 I 
JNP 
P2PNNT 
621 
IEG8 
7D 
P2C88 
NOll 
A ..L 
622 
IECC 
FEOI 
CPI 
I 
623 
lEGE 
C2E31E 
INE 
P2C:3F 
624 
IEOI 
:::AL>516 
LOA 
LACHRF' 
625 
IE04 
C3G21£ 
INP 
P2C8A 
626 
IE07 
3AAE22 
P2CBD 
LOA 
EF.:F:OF:5 
627 
IEDA 
F60! 
ORI 
UNOFBT 
628 
IEDC 
32AE22 
P2C8E 
5TA 
EF:ROf6 
629 
IEDF 
RF 
ZAF' 
63'0 IEEfJ C3C21E 
JNP 
P2C8A 
63'1 IEE3 
3ARE22 
P2C8F 
LOA 
E(.;'RoPS 
632 
IEE6 
F602 
OF:I 
LNTHBT 
633 
lEES 
C3DCIE 
JNP 
P2C8E 
634 
.'/< 
635 
.'/< 
T'r'PE9 PROCESSOF: 
636 
.'/< 
637 
IEE8 
3E02 
P2C9 
NVI 
1'1 .• 2 
638 
IEEO 
32RF22 
STA 
P2LNTH 
SET 
LENGTH 
63':~IEFO 
JR8S07 
LDA 
SkEL 
640 
IEF3' FEOO 
CPI 
tl 
641 
IEF5 
CAfJ91F 
JEt:! 
P2LPA 
642 
IEF8 
FEfJI 
CPI 
{ 
643 
IEFA 
CAOFIF 
JEO 
P2TCA 
644 
IEFD 
2AI51F 
LHLO 
STPCOL> 
645 
IF@[f 228022 
P2C9A 
SHLD 
OCODE 
646 IFt13 CDI223 
P2C98 
CALL 
PCH08J 
647 
IFfJ6 C3F52 
1 
RIP 
P2?PNT 
648 
{F09 
2AI7IF 
P2LPA 
LHLD 
L(';'ACOD 
649 IFtlC C3l101F 
IN? 
P2C9A 
650 
IFOF 
2AI91F 
P2TCA 
LHLO 
TCACOL> 
651 
IFI2 
C30tliF 
JNP 
P2C9A 
652 
IFI5 
F8 
5 TPCOD 
EI 
653' IFI6 
76 
HLT 
6:;4 
IFI7 
B~ 
LRACOD 
0(,;'1'1A 
,. 
655 
IFIS 
IF 
NAP 
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656 
IFI9 
2F 
657 
IFIA 
3C 
658 
65:~ 
660 
661 
IFIB 
3EOI 
662 
IFID 
32AF22 
663 
1F2t1 COOF 15 
664 
IF23 
CDE51F 
665 
IF26 
OA3EIF 
666 
IF29 
7D 
667 
IF2R 
87 
668 
IF2B 
FR3EIF 
669 
IF2E 
FEi3!3 
610 
IF3i3 D23EIF 
67/ 
IF3.] 87 
672 
IF34 87 
673 
JF35 
87 
674 
IF36 
F6C? 
6'75 IF38 
328022 
676 
1F3B 
C3£'31F 
607 
IF3E 
3AAE22 
618 
IF41 
F60/ 
679 
IF43 
32RE22 
680 
IF46 
C3031F 
681 
6B2 
68:3 
6S4 
685 
686 
687 
688 
689 
690 
691 
692 
IF49 
3E03 
693 
IF4B 
32RF22 
694 
IF4E 
3AR807 
695 
1F51 
FEAiJ 
696 
IF53 
C2591F 
697 
IF56 
3RR707 
698 
IF59 
CDDRIF 
699 
IF5C 
32B022 
7£10 1F5F 
3RS507 
701 
IF62 
328/22 
702 
IF65 
CDlJFI5 
7tH 
1F68 
CDE51 F 
7t14 
1F68 
PR 1120 
70~; IF6E 
WF41F 
706 
1F71 
DA292t1 
7'l~? }F?4 228222 
?t18 
709 
7/0 
711 


** 
T'r'PE 
*P2CR 
NIl] 
STR 
CALL 
CALL 
JC 
NOli 
OF<'R 
IN 
cpr 
JGE 
ADO 
ADO 
ADD 
OR] 
STR 
IN? 
LDR 
ORI 
STR 
JNP 


R .. I 
P2LNTH 
FANL','Z 
TCHKI 
P2CRE 
R ..L 
R 
P2CAE 


P2CAE 
A 
A 
A 
:C? 
OCOOE 
P2C9B 
ERRORS 
UNDFBT 
ERROFi'S 
P2C98 


:+: 
***** ****** ******** ** **** ****** *,~.****,•.** ****** * 
* 
* 
* 
28lJ INST/T.'UCTION H'PES 
B 
THROUGH 
19 
* 
* 
* 
********************************************** 
*** CLASS 
B 
*P2CB 
rWI 
STA 
LDA 
CPI 
JNE 
LDR 
CALL 
STR 
LOA 
STR 
CALL 
CALL 
JC 
CALL 
JC 
SHLD 


A ..3 
P2LNTH 
NNEN+3 


P2CBI 
NNEN+2 
DOFDX'r' 
OCODE 
SkEL 
OCOOE+/ 
FANL'r'Z 
TCHKI 
P22UER 
ZL7CHK 
P2Z0ER 
OCODE+2 
** FOLLOI4ING 
FLAGS 
280 
ONL'r'INSTRUCTIONS 
NITH 
* A DOLLAR 
SIGN 
<" $'> 
HlO 
COLUNNS 
BEFORE 
THE 
* LABEL 
IN 
THE 
ASSEI18L','LISTING. 
*FLGZ80 
NVI 
R ..'$" 


714 
IF79 329B07 
STA 
LABEL-2 
7/5 
IF7C 
3ASCIF 
LOA 
IL8080 
7/6 
IF7F 
B? 
ORA 
A 
7/7 
IFS0 
CA051C 
JZ 
P2CIB 
718 
IF83 
218907 
LXI 
H ..HEX 
719 
IF86 
C09901 
CALL 
PRY 
720 
IF89 
C3D51C 
Jt1P 
P2CIB 
721 
IFSC 
L~(1 
IL80S0 
*** 
122 
* 
723 
* CLASS 
C 
724 
* 
725 
IF8D 
3EfN 
P2CC 
MYI 
A ..4 
726 
IF8F 
32AF22 
STA 
P2LNTH 
727 
IF92 
3AA707 
lOA 
MNEM+2 
?28 
IF95 
COOAIF 
CALL 
DDFDX~' 
729 
IF98 
328(122 
5TA 
OCODE 
73(1 IF98 
3E36 
Mill 
A, '36 
731 
IF9D 
328122 
STA 
OCODE+I 
732 
IFRO 
C00FI5 
CRLL 
FANL ~'Z 
733 
IFA3 
FERC 
CPI 


..' 
.' 
MUST 
END 
IN 
COMMA 
734 
IFA5 
C21120 
JNE 
P2ZUE:.R 
735 
IFR8 
CDE51F 
CALL 
TCHKI 
736 
IFRB 
ORI12fj 
JC 
P2ZUER 
737 
IFRE 
CDF4/F 
CALL 
ZUCHK 
738 
IF81 
DA292fj 
JC 
P2ZDER 
739 
IFB4 
228222 
SHlO 
OCODE+2 
740 
IF87 
CDt1f'-15 
CALL 
FANL'r'Z 
741 
/FBR 
DAL~620 
JC 
P2ZLER 
742 
/FBD 
78 
Mall 
A,8 
743 
IF8E 
FE132 
CPI 
2 
744 
IFCfj FAI12fj 
J( 
P2ZUH: 
745 
/FC3 
FE20 
CPi 
32 
746 
IFC5 
DR041F 
JAL 
P2CC2 
747 
IFC8 
C2/120 
JNE 
P2ZUER 
748 
/FCE; 7D 
Mall 
A ..L 
749 
IFCC 
FEO/ 
CPI 
1 
75tl IFCE 
C2t162t,t 
lNE' 
P2ZLER 
75/ 
IFDI 
2AD516 
LHlO 
LRCHRR 
752 
IFD4 
228322 
P2CC2 
SHLD 
OCODE+3 
753 
IF07 
C3771F 
JMP 
FLGZ80 
754 
* 
755 
* DETERMINE 
"00 OR 
"FD PPEF 1.x,' FROM 
756 
* PRESENCE 
OF 
"};.'" 
OF: "'r'" 
757 
* 
758 
IFDR 
06DD 
LJDFDX~' 
Mill 
B, "DD 
759 
IFDC 
FED8 
CPI 
/x~· 


76tl IFDE 
CRE31F 
JHl 
DDFDZ2 
761 
IFEI 
06FD 
Mill 
8..'FD 
762 
IFE3 
78 
DDFDZ2 
MOI/ 
R ..B 
763 
IFE4 
C9 
RET 
764 
* 
765 
* CHECK 
OPERAND 
T'r'PELIMITS 
766 
* 
767 
IFE5 
78 
TCHKI 
MOil 
A ..B 
768 
IFE6 
FE132 
CPI 
2 
769 
IFE8 
FRF21F 
J( 
TCHK2 
??l:t 
IFEB 
FE2tl 
CPI 
~., 
-~ 
77/ 
1FED 
D2F21F 
JGE 
TCHK2 
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772 
IFFO 87 
773 
IFFI 
C9 
7?4 
IFF2 
31 


775 
IFF3 
C9 
??6 


RSC 
RET 
TCHK2 
STC: 
RET 


.'/< 


.'/< 


.'/< 


.'/< 


.'/< 


.'/< 
ZL7CHK 


??'? 
??8 
779 
78ft 
781 
782 
IFF4 
?C 
783 
IFF5 
87 
?84 
IFF6 
CAti020 
785 
IFF9 
FEFF 
786 
IFFE: CA082ti 
787 
IFFE 
37 
788 
IFFF 
C9 
789 2(180 AD 
790 
ZtiOI FAFE IF 
791 
2084 
87 
792 20t15 C9 
?93 
794 
795 
796 
797 
798 
799 
80ti 
801 
882 
8133 
804 
805 
8ti6 
8l~? 
8t18 
889 
8/0 
811 
8/2 
813 
814 
815 
816 
817 
8/8 
819 
820 
82/ 
822 
823 
824 
825 
826 
821 
828 
829 


CHECK 
FANL IlZ 
RESUL T FOR 
VALlD 
SINGLE 
F'RECIS ION 
SIGNED 
NU/'18ER. RETURN 
14ITH 
CARRY 
ON 
IF 
GREATER 
THAN 
SINGLE 
PRECISION 
(7 
8ITS 
+ SIGN) 
IN 
H&L. 


/'1ll\i 
ORA 
JZ 
CPI 
JEl~ 
STC 
RET 
XRA 
J/'1 
RSC 
RET 


A .•H 
A 
ZL?C2 
'FF 
ZL7C2 


.'/< 


.'/< 
28t1 ER"'OR HANDLERS 


.'/< 
2006 
3AAE22 
P2ZLER 
lOA 
ERRORS 
2889 
F602 
ORI 
LNTH8T 
2808 
32RE22 
P2ZL2 
STA 
ERRORS 
2130E C3771F 
JNP 
FLGZS13 
2011 
3AAE22 
F'2ZUER 
LDA 
ERRORS 
2814 
F6('I/ 
ORI 
UNDF8T 
2£,116C30820 
I/'1P 
P2ZL2 
2£,1193AAE22 
P2ZRER 
lOR 
ERRORS 
20lC 
F61f.t 
ORI 
"'EBIT 
20lE 
C3138213 
J/'1P 
P2ZL2 
202/ 
3AAE22 
P2ZAER 
lOA 
ERRO"'S 
2024 
F64l1 
ORI 
RDf.;'8IT 
2026 
C3ti820 
RtP 
P2ZL2 
2liJ29 
3AAE22 
P2ZDER 
lOR 
ERRORS 
2l=t2C F6Sti 
0"'1 
DSPBIT 
202E 
C313820 
JNP 
P2ZL2 


.'/< 


.'/< 


.'/< CLASS 
D 


.'/< 
2031 
3EOI 
P2CD 
/'11/1 
ft., 1 
2033 
32RF22 
STA 
P2LNTH 
2036 
3ASS07 
lOA 
SKEL 
2&39 
328(~22 
STA 
OCODE 
2ti3C C377 1F 
J/'1P 
FLGZ80 


.'/< 


.'/< CLASS 
E 


.'/< 
2133F 3E02 
P2CE 
NV I 
A ..2 
2041 
32RF22 
STA 
P2LNTH 
2044 
3EED 
/'1VI 
ft .. 'ED 
21346 328822 
STA 
OCODE 
2049 
~RR607 
lOA 
/'1NE/'1+1 
284C 
8E8R 
/'1VI 
C ..'R 
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PAGE 
67 
Z80 
RESIDENT 
EDITOR/ASSEMBLER 


83tl 204E 
FECI 
CPI 
'"A" 


83/ 21150 CA5520 
JEO 
P2CE2 
832 
2053 
tlE02 
NI/I 
C ..2 
833 
2055 
IA 
P2CE2 
LDAX 
D 
834 
2(156 FEDl1 
CPI 
"'p.' 


835 
2058 
CAI92l1 
JHI 
P2ZREF: 
836 
2(15B CD8EID 
CALL 
SDRF 
837 
205E 
DA 1920 
JC 
P2ZRER 
838 
2(161 C604 
AD! 
4 
839 2863 
87 
ADD 
A 
840 
2(164 87 
ADD 
A 
841 
2065 
87 
ADD 
A 
842 
2(166 R7 
ADD 
A 
~, 
843 
2067 
B/ 
ORA 
C 
844 2068 
328122 
STA 
OCOOE+I 
845 
2l16B C377IF 
JNP 
FLGZ80 
846 
-'Ie 
847 
-'Ie CLASS 
F - LXI 
X/'r'- FED 
8'r' 8080 
CLASS 
5 
848 
-'Ie 
849 
2l~6E 3E114 
P2CF 
1'71/1 
A ..4 


850 2(170 32RF22 
5TA 
P2LNTH 
851 
ZG73 
IA 
LDAX 
D 


852 2(174 CDDAIF 
CALL 
DDFDX'r' 
853 
2ft?? 
328022 
STA 
OCODE 
854 
2t17A 
3E21 
NI/I 
R ..'21 
855 
2t17C' 328/22 
STA 
OCOD£+I 
856 
207F 
13 
INX 
D 
85? 2080 
IA 
LDAX 
D 
858 
2381 
FEAC 
CPI 
NUST 
BE 
caNNA 
859 2(~83 C21120 
JNE 
P2ZUER 
860 
21186 
13 
INX 
0 
861 
2887 
CDOFI5 
CALL 
FRNL'r'Z 
862 
208A 
78 
NO 1/ 
A ..8 
863 
208B 
FE02 
CPI 
2 
864 
2tlSD 
FRI120 
J( 
P2ZUER 
865 211911FE20 
CPI 
'32 
866 2092 
ORA520 
JAL 
P2CF3 
867 
21195 C21120 
JNE 
P2ZU£R 
868 
2t198 7D 
P2CF2 
NO\/ 
A ..L 
869 
2099 
FEIJ3 
CPI 
3 
818 
209B 
02t1620 
JGE 
P2ZLER 
87/ 
209E 
B7 
ORA 
A 
~7"" 
209F 
CA0623 
JZ 
P2ZLEF: 
~,~ 
873 
20A2 
2AD516 
LHLD 
LACHAR 
874 
2(1A5 228222 
P2CF3 
SHLD 
OCODE+2 
875 
20A8 
C377IF 
JNP 
FLGZ8f1 
876 
-'Ie 
877 
-'Ie CLASS 
10 
878 
-'Ie 
879 2l1AB 3ElN 
P2CI0 
Mill 
R ..4 
883 
20AL> 32RF22 
STA 
P2LNTH 
881 
2l1BO l16EO 
M~'I 
B ..'ED 
882 
2&82 
3AA807 
LOA 
NNEM+3 
883 
20B5 
FEAO 
CPI 
SB4 
20B7 
C2C020 
JNE 
P2CIOB 
885 
2l1BA 3AA60? 
LDA 
NNEN+/ 
886 2l1BO CDDAIF 
CALL 
DDFDX'r' 
887 
20CO 
78 
P2CIOB 
NOV 
A ..S 
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PAGE 
68 
Z8ti RES IC>ENT ED1TOR/ASSEN8LER 


888 
Z8CI 
328022 
STA 
[lCODE 
889 
ZOC4 
3A85137 
LDA 
SKU 
898 
2tlC? 328/22 
5TR 
OCODE+I 
891 
20CA 
CD13FI5 
CALL 
FRNL'r'Z 
89Z 
ZOCD 
CDE51F 
CRLL 
TCHKI 
893 
2tlDO DAI12l'l 
JC 
P2ZUER 
894 
2tlL>3C3R520 
JNF' 
P2CF3 
895 
'" 
896 
'" 
CLRSS 
II 
897 
'" 
898 Ztl06 3£8Z 
PZCII 
NI/1 
R 
.~ 
.'~ 
899 
2t.1D8 3ZAF22 
STR 
P2LNTH 
98tf 2tlDB IA 
WAX 
D 
981 
2£-lDCCDDAIF 
CALL 
ODFDX'r' 
98Z 
280F 
328022 
PZCIIR 
STR 
OCOOE 
983 
20£2 
3A85t17 
LDA 
SKEL 
9t14 28E5 
328/22 
5TR 
ClCODE+1 
9l~5 Z8E8 
C3??IF 
J/'IP 
FLGZ813 
986 
'" 
907 
* CLRSS 
12 
9t18 
.'/< 
909 
28E8 
3£02 
P2CI2 
/'IV 
1 
A ..2 
91tl ZtlED 32RF22 
STR 
PZLNTH 
911 
28F8 
3EED 
m1 
R ..'ED 
912 
2tlF2 C3DF28 
JNP 
P2CIIR 
913 
'" 
914 
'" 
CLASS 
13 
915 
.'/< 
916 
Z8F5 
3Et12 
PZCI3 
/'IV 
1 
R 
.~ 
.'';'" 


917 
28F7 
32RF22 
STA 
P2LNTH 
918 
Z8FA 
3EC8 
/'11/1 
R ..'C8 
919 
Zl1FC C3DF28 
J/'IF' P2CIIA 
9Ztl 
'" 
92/ 
* CLASS 
14 
q"j'j 


'" 
- ~~ 
923 
Zl'lFF3E82 
P2CI4 
/'11/1 
R ..2 
9Z4 
2181 
32RF22 
STfI 
F'ZLNTH 
925 
2184 
3R85B? 
LOA 
SKEL 
926 
2/t17 
32Bl122 
STR 
ClCODE 
9'~7 ZIBR 
CDl~F/5 
CALL 
FRNL'r'Z 
- ~, 
928 
2WO 
CDE51F 
CALL 
TCHKI 
929 
2118 
DA//28 
JC 
PZZUER 
938 
2//3 
E8 
XCHG 
931 
2114 
2A88 18 
LHLD 
1LC 
932 
2//7 
23 
INX 
H 
933 
2/18 
23 
1NX 
H 
9~'4 2119 
CD3384 
CRLL 
NEGHL 
935 
211C 
19 
DAD 
0 
936 
2110 
CDF41F 
CRLL 
ZL7CHK 
937 Z1213 DA212B 
JC 
P2ZAER 
936' 2/23 
228/22 
SHLD 
OCODE+I 
939 
2126 
C37?IF 
JNP 
FLGZ8e 
948 
.'/< 
941 
.'/< CLASS 
15 
942 
'" 
943 
2/29 
3E82 
P2CI5 
/'11/1 
A ..2 
944 
2128 
32RF22 
5TA 
P2LNTH 
945 
212E 
3EC8 
/'IV 
1 
A ..'C8 
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946 2/38 
3281322 
947 2/33 
CDOF/5 
948 
2/36 
DA13620 
949 2/39 
CDE5/F 
950 
2/3C 
DA/1213 
951 2/3F 
7D 
952 
2/40 
FE88 
953 2/42 
D2136213 
954 2/45 87 
955 2/46 
87 
956 2/47 87 
957 2/48 
47 
958 2/49 
3A8587 
959 
2/4C 
80 
960 
2/4D 
328/22 
96/ 
2/58 
C377/F 
962 
963 
964 
965 
2153 
3E04 
966 2/55 
32AF22 
967 2/58 
3RR807 
968 2/58 
CDDR/F 
969 
2/5E 
328022 
97fJ 2/6/ 
3EC8 
97/ 2/63 328/22 
912 2/66 
CDaF/5 
973 2/69 
CDE5/F 
974 
216C 
DAI/28 
975 
2/6F 
CDF41F 
976 
2172 
L>R2928 
977 
2175 
228222 
978 
2178 
3R85fJ1 
979 
2178 
328322 
980 
2/7E 
C3?71F 
98/ 
982 
983 
984 
2181 
3E84 
985 
2183 
32AF22 
986 
2186 
3RR807 
987 
2189 
CDDA/F 
988 
218C 
328822 
989 
218F 
3ECB 
998 2/9/ 
32B/22 
99/ 
2/94 
CD8FI5 
992 2/97 FERC 
993 
2199 
C2/128 
994 
219C 
CDE5/F 
995 
219F 
DRI/28 
996 
21R2 
CDF41F 
997 
21R5 
DR2928 
998 
2/R8 
228222 
999 
21RB 
CD8F/5 
880 
21RE 
78 
881 
21RF 
FE82 
882 
21BI 
FR//20 
883 
2184 
7D 


.." 
.."CLRSS 
16 


.." 
P2CI6 
/'IVI 
STR 
lOR 
CRLL 
STR 
/'II/I 
STA 
CRLL 
CALL 
JC 
CRLL 
JC 
SHLD 
LOA 
STA 
J/'IP 


.." 
.."CLRSS 
17 


.." 
P2CI7 
/'IVI 
STR 
LDR 
CRLL 
STA 
/'II/I 
STA 
CRLL 
CPI 
JNE 
CRLL 
JC 
CRLL 
JC 
SHLD 
CRLL 
/'IO~' 
CN 
J<: 
/'10 V 


5TA 
CRLL 
JC 
CALL 
Je 
/'lOll 
CPI 
JGE 
ADD 
ADD 
ADD 
/'101/ 
lOA 
ORA 
STA 
J/'IP 


OCODE 
FRNL~'Z 
P2ZLEF: 
TCHKI 
P2ZUER 
A ..L 
8 
P2ZLER 
A 
R 
R 
B.oA 
SKEL 
B 
OCODE+I 
FLGZ8fJ 


A ..4 
P2LNTH 
/'INE/'/+3 
DDFDX~' 
OCODE 
A ..'CB 
OCODE+I 
FRNL~'Z 
TCHKI 
P2ZUER 
ZL7CHK 
P2ZDER 
OCODE+2 
SKEL 
OCODE+3 
FLGZ8fJ 


A ..4 
P2LNTH 
I'/NE/'f+3 
DDFDX'r' 
OCODE 
R .. 'CB 
OCODE+/ 
FRNL'r'Z 


PZZUER 
TCHKI 
P2ZUER 
ZL1CHK 
P2ZDER 
OCODE+2 
FANL'r'Z 
A ..S 
2 
P2ZUER 
R .. L 


PAGE 
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t104 2185 
FEOS 
CPI 
S 


01:152/87 
D2062tl 
JGE 
P2ZLER 
006 
21BA 
8::- 
ADD 
A 
". 
1:10721BB 
87 
ADD 
A 
tltlS 
21BC 
81 
ADD 
ft 
Ot'l9 21BD 
47 
1'10V 
B ..A 
tlW 
21BE 
3RS5tl? 
LDR 
SkEL 
01/ 
21CI 
BO 
ORR 
B 
t1/2 2/C2 
328322 
sTR 
OCODE+3 
013 
21C5 
C3?7IF 
J1'1P 
FLGZStl 
t114 
-"I< 
015 
-"I< 
CLRSs 
18 
1:116 
-"I< 


t'll721CB 
3E02 
P2CI8 
1'1VI 
R 
., 
.'':'' 


t'liS2/CR 
32RF22 
STR 
P2LNTH 
019 
21CD 
3EDD 
I'll/I 
R ..'DO 
02tl 
2/CF 
328022 
P2CISR 
sTR 
OCODE 
021 
21D2 
3R8507 
LDR 
sKEL 
fiZ2 21D5 
320'/22 
sTft 
OCOD£+I 
023 
21D8 
C3??IF 
JNP 
FLGZ80 
t'l24 
-"I< 
1325 
-"I< 
CLRSs 
19 
t126 
-"I< 
827 21D8 
3E02 
P2CI9 
NVI 
A 
., 
..•... 


t'l28 
210D 
32RF22 
5Tft 
P2LNTH 
029 
21EI:13EFD 
1'1VI 
R ..'FD 
t13t1 2/E2 
C3CF21 
JPIP 
P2CISR 
(HI 
-"I< 


t.132 
-"I< 


033 
-"I< 


034 
-"I< 
BRD 
NNENONIC 
PROCESSOR 
035 
-"I< 


tU6 
21E5 
3Et14 
P2BDOP 
NVI 
ft..4 
037 
2/E7 
32RF22 
5TA 
P2LNTH 
tUS 
21ER 
3ARE22 
LDR 
ERRORS 
039 
21ED 
F6213 
ORI 
OPBIT 
040 
21EF 
32AE22 
sTR 
ERRORS 
041 
21F2 
C3031F 
JNP 
P2C9B 
1342 
-"I< 
043 
-"I< 
PRINT 
NRCHINER'r' 


t144 
-"I< 
045 
21F5 
3AB91S 
P2PRNT 
LDA 
ILC+I 
tN6 
2/FS 
C08513 
CRLL 
CN~'2HX 


047 
21FB 
32SD137 
5TA 
HEX+4 
tNS 
21FE 
78 
NOV 
R ..B 
1149 21FF 
J28Et17 
sTA 
HEX+5 
fl5tl 
2282 
3ABS/S 
LDA 
ILC 
05/ 
2205 
CDS513 
CRLL 
CNV2HX 


052 
2208 
328F07 
sTA 
HEX+6 
053 
22118 
78 
NOV 
A ..S 
t154 
220C 
329ttO? 
sTA 
HEX+7 
055 
2ZaF 
3ARF22 
LDA 
P2LNTH 
056 
22/2 
B? 
ORA 
A 
057 
22/3 
CA3222 
JZ 
P2PRC 
058 ~:216 FE05 
CPI 
5 
O~S9 22/8 
DA/[)22 
JAL 
P2PRA 
060 
2218 
3E04 
NVI 
A ..4 
061 
22/L> 4F 
P2PRA 
NOll 
C ..A 
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PAGE 
71 
Z80 
RESIDENT 
EDITOR/ASSEM8LER 


062 22/£ 
2/8t.122 
LXI 
H ..OCOOE 


063 
222/ 
119207 
LXI 
D ..HEX+-9 
ti64 2224 
7£ 
P2PR8 
MO~' 
A ..N 
CONVERT 
LOOP 
l~65 2225 
23 
INX 
H 
066 
2226 
C08513 
CALL 
CN\l2H>: 
867 
2229 
12 
STAX 
D 
068 
222R 
13 
INX 
D 
069 
2225' 78 
NOV 
A ..8 
ti?O 222C 
12 
STAX 
D 
L~71 222D 
13 
INX 
D 
t172 
222£ 
tiD 
DCR 
C 
l:t?3 222F 
C22422 
JNZ 
P2PRB 
tiN 
2232 
3RAE22 
P2PRC 
LDA 
ERRORS 
l~75 2235 
87 
ORA 
A 
076 
2236 
CR5C22 
JZ 
P2PRCR 
t~?? 2239 
OE08 
NIl I 
C . .'3 
CONI/ERT 
ERROR 
LINE 
t178 2238 
2/D822 
LXI 
H ..EF-..'CDZ 
ti?9 
223E 
IIE622 
LXI 
D ..ECA 


080 
2241 
46 
P2PRG 
NlW 
B ..N 
081 
2242 
IF 
RRR 
082 
2243 
D24822 
JNC 
P2PF:H 
083 
2246 
F5 
PUSH 
PSN 
084 
2247 
78 
NOV 
A ..B 
085 
2248 
I'j 
STR,'x,'D 
~ 
1;186 2249 
FI 
POP 
PSH 
l~87 224R 
13 
INX 
0 
ess 2248 23 
P2PRH 
INX 
H 
08:~ 224C 
00 
DCR 
C 
&90 
224D 
C24122 
JNZ 
P2PRG 
09/ 
2250 
218907 
LXI 
H ..HE,x; 
092 2253 
CD9901 
CRLL 
PRT 
tl93 2256 
2/£222 
LXI 
H ..ERLNE 
094 
2259 
CD9901 
CALL 
PRT 
tl95 225C 
3AAOl3 
P2PRCA 
LDR 
PRFLRG 
096 
225F 
87 
ORA 
A 
tl:~? 226J3 
CR7622 
JZ 
P2PRF 
f.19B 2263 
2/89t17 
P2PF-..'0 LXI 
H ..HEX 
099 
2266 
CD6CI4 
CALL 
LPNT 
PRINT 
LINE 
Itl(12269 
3RRE22 
LDA 
ERPO/i:S 
CHECK 
FOR 
ERROR 
FLRGS 
Il~/ 226C 
87 
ORA 
R 
1fJ2 
226D 
CR7622 
JZ 
P2PRF 
103 2270 
2/£"222 
LXI 
H ..ERLNE 
104 2273' C06C/4 
CRLL 
LPNT 
/85 
2276 
3A84f17 
P2PRF 
LOR 
CLRSS 
CHECK 
FOR 
II END " 
Iti6 2279 FE80 
CPI 
:80 
W7 2278 C28622 
JNE 
P2PRI 
1fJ8 
227£ 
3AB.5l37 
LDA 
SkU 
/09 228/ 
FEiJI 
CPI 
I 
I/O 
2283 
CA9822 
JEP 
PTRLR 
III 
2286 
3RRF22 
P2PRI 
LDR 
P2LNTH 
112 2289 
4F 
NOV 
C ..R 
1/3 
228R 
0600 
N~'I 
8 ..0 
114 228C 
2AB8/S 
LHLD 
ILC 
UPDRTE 
LOCRTION 
COUNTER 
115 228F 
l'19 
DAO 
B 
1/6 
2290 
EB 
XCHG 
1/7 
229/ 
2AEF22 
LHLD 
RSLNTH 
1/8 
2294 
19 
DAD 
0 
119 
2295 
2288/8 
SHLLI 
ILC 
RESTORE 
LOCRTION 
COUt·ITER 
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121:.12298 
121 
229B 
122 229E 
123 
22RO 
124 
22A3 
125 
22R4 
126 22A? 
/2;"" 
128 
22RR 
/29 
22RB 
/30 22RC 
13/ 
22RE 
/32 
22RF 
/33 
2280 
/34 22D8 
D5CCD3CD 
135 22EO 
11('i('i11 
136 22E2 
RORORORO 
137 
22E6 
/3S' 
22££ 
8D 
/39 22EF 
11000 
140 
141 
142 
143 
144 
/45 
146 
147 
/48 
22Ft 
41 


149 22F2 
3ARI/3 
150 22F5 
B1 
/5/ 
22F6 
CROl23 
152 22F9 
RF 
153 22FR 
C07RO/ 
154 22FD 
05 
155 22FE 
C2FA22 
156 230/ 
210000 
157 2304 
22E023 
158 2307 
RF 
/59 
23t18 32£223 
160 2308 
21£523 
/6/ 
23('i£ 22£323 
/62 23/! 
C9 
163 
164 
/65 
/66 2'3/2 
3RRF22 
/61 23/5 
87 
168 23/6 
C8 
169 23/7 
47 
/70 
23/8 
3RE223 
/?I 
2318 
80 
/72 23/C 
FESI 
/73 
23/£ 
DFf2?23 
/74 232/ 
CD3C23 
175 2324 
C3/22J 
/?6 2327 32E223 
177232ft 
/18022 


C3D7J9 
CD3C23 
3E46· 
COFI22 
C9 
3/0001 
C31901 


00 
00 
OOOtl 
('i0 
00 


* 
FCFLRG 
FLCHRR 
P2LNO 
EI,:RORS 
P2LNTH 
OeoDE 
ERCDZ 
P20PTF: 
ERLNE 
ECA 


JNP 
CRLL 
!'IV I 
CRLL 
RET 
LXI 
JNP 


P2R 
PPOBJR 
R.. 70 
PCHBLT 


RSLNTH 
********************************** 
'"'" OBJECT 
OUTPur 
Dl"n'ERS 
* 
'"* PUNCH 
LERDER/TRRILER 
*eCHBL l' 
NOli 
lOA 
ORR 
JZ 
ZRR 
CRLL 
OCR 
JNZ 
LXI 
SHLD 
ZRR 
STR 
LXI 
SHLO 
RET 


SP ..NON 
NON2 


"'*'" 
**'" 
DBL 
"''''* 
"'** 
RES 
ASC 
D8L 
ASC 
RES 
OATR 
DBL 


40 
"ULSNROAV 
o 


S 
:BD 
o 


*'" ENTER 
OBJECT 
INTO 
PUNCH 
BUFFER 
*PCHOBJ 


B ..R 
OBFLRG 
A 
PCHBL3 


PCHCHR 
B 
PCHBL2 
H., tl 
RCDORG 


RWSIZ 
H ..RCDBLI< 
RCDPTF: 


LDR 
ORR 
RZ 
NOV 
LDA 
RDD 
CPI 
JRL 
CRLL 
JNP 
STH 
LXI 


B..R 
RCDSIZ 
B 
:8/ 
PCHOS2 
DPOBJR 
PCHOBJ 
1<.'CDSIZ 
D ..oeODE 


~~S.. DUNP 
EXISTING 
RECORD 
RND 
THEN 
DO 
IT 


PAGE 
73 
280 
RESIDENT 
ED I TOR/ASSEMBLEI': 


I~.,232D 
2RE323 
LHLD 
RCDPTR 
"0 
179 
2330 
IA 
PCH083 
LDA.'.·D 
180 233/ 
77 
NOll 
N ..A 
TRANSNIT 
OBJECT 
CODE 
181 2332 
13 
INX 
0 
/82 2333 
23 
INX 
H 
183 
2334 
05 
OCR 
8 
184 2335 
C23023 
JNZ 
eCH083 
185 2338 
22£32-3 
SHW 
RCDPTR 
/86 2338 
C9 
RET 
187 
* 
/88 
* PUNCH 
OUT 
08JECT 
RECORD 
/89 
* 
190 23JC 3AAI13 
DP08JR 
LDA 
08FLAG 
191 
233F 
87 
ORA 
A 
192 
2340 
CA?C23 
JZ 
DP08J3 
193 2343 
3AE223 
LOA 
RCDSIZ 
194 2346 
8? 
ORA 
A 
195 2347 
CA?C23 
JZ 
DPOBJ3 


196 234A 
4? 
NOll 
B ..A 
/97 
2348 
AF 
ZAR 
/98 234C 
CD?AOI 
CALL 
PCHCHR 
199 234F 
30 
OCR 
A 
2£10 235tl 
16£10 
NIlI 
D ..O 
CLEAR 
CHECKSUN 
2l~I 2352 
CDD823 
CALL 
PCHFRN 
PUNCH 
RECORD 
NARK 
202 
2355 
2AEli23 
LHLD 
RCOO,,"'G 
an 2358 
?O 
NO\:' 
A ..L 
2tN 
2359 
COD823 
CALL 
PCHFRN 
205 
235C 
7C 
MOl' 
A ..H 
206 
235D 
CD0823 
CALL 
PCHFRN 
PUNCH 
ORIGIN 
211'? 2360 
AF 
ZAR 
208 
2361 
CDD823 
CALL 
PCHFRN 
PUNCH 
RECORD 
H'PE 
2@9 
2364 
78 
NO'" 
A ..B 
210 
2365 
CDD823 
CALL 
F'CHFRM 
PUNCH 
RECORO 
LENG[H 
21 I 2:~68 21E523 
LXI 
H ..RCDBLK 
2/2 
2368 
?E 
DP08J2 
NOll 
A ..N 
213 
236C 
23 
IN.x,· H 
214 
2360 
CDD823 
CALL 
PCHFRN 
215 
2370 
@5 
OCR 
8 
216 
237/ 
C26823 
1NZ 
OP0812 
2/7 
2374 
?A 
MOil 
A ..D 
218 
2375 
CD?AOI 
CALL 
PCHCHR 
PUNCH 
CHECKSUN 
2/9 
2378 
AF 
ZAR 
220 
2379 
CD?Atll 
CALL 
PCHCHR 
221 
237C 
2AB8/8 
DP0813 
LHLD 
ILC 
SET 
NHI 
RECORO 
ORIGIN 
222 
237F 
22£t.123 
SHLD 
RCDOl"G 
223 
2382 
AF 
ZAR 


224 
2383 32£223 
STA 
RCDSIZ 
225 
2386 
21E523 
LXI 
H ..RCDBLK 
,,"'ESETADORESS 
POINTER 
226 
2389 
22£323 
SHLD 
RCDPTR 
227 
238C 
C9 
RET 
228 
* 
229 
* PUNCH 
"F;,'ES" 
H'PE 
RECORO 


23t1 
* 
231 
238D 
CD3'C23 
PCHRES 
CALL 
DPOBJR 
CLEAR 
PRH'IOUS 
RECORO 
232 
2390 
3AAI13 
LDA 
OBFLRG 


233' 
2393 
B? 
O,,"'A A 
234 
2394 
CACC23 
1Z 
PCHR53 
23.5 2397 
2100FF 
LXI 
H .."FFOO 
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PAGE 
74 
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236 
239A 
22£523 
sHLD 
RCDBLK 
237 
239D 
2RE023 
LHLD 
RCDO"'G 
238 
23RO 
22£123 
sHLD 
RCDBLK+2 
SET 
UP 
PUNCH 
RECORD 
239 
23R3 
3EO/ 
rWI 
A ..I 
RECORD 
n'PE 
240 
2.JR.5 32£923 
sTR 
RCDBLK+4 
241 
23RS 
2RAA22 
LHLD 
FCFLRG 
242 23R8 
22EA23 
sHLD 
RCD8LK+5 
243 23RE 
2REF22 
LHLD 
RsLNTH 
244 2381 
22EC2J 
sHLD 
RCD8LK+7 
245 
23B4 
(J6l~9 
1'1 
V1 
8..9 
246 
2386 2/E523 
LXI 
H ..RCD8LK 
247 23B9 
16l~0 
Nil1 
D ..0 
CLEAR 
CHECKsUN 
248 2388 1£ 
PCHRs2 
1'101/ 
R,N 
249 23BC 
eDD823 
CALL 
PCHFRN 
250 
23BF 23 
INX 
H 
25/ 
23Ct::' 
as 
DCR 
8 
252 
23CI 
C28823 
JNZ 
PCHRs2 
253 
23C4 
7R 
NOV 
A,D 
254 
23C5 
CD7A£1/ 
CALL 
PCHCHR 
PUNCH 
CHECKsUN 
255 
23C8 
RF 
ZRR 
256 
23C9 
CD7At'l 
CALL 
PCHCHR 
257 23CC 
2REF22 
PCHRs3 
LHLD 
RsLNTH 
258 
23CF 
E8 
XCHG 
UPDRTE 
RECORD 
ORIGIN 
259 
23DO 
2AB818 
LHLD 
ILC 
260 
2303 
19 
DRD 
[.I 
26/ 
23D4 
22£023 
sHLD 
RCDORG 
262 
2307 
C9 
RET 
263 
* 
264 
* PUNCH 
FRANE 
RND 
KEEP 
CHECKsUN 
265 
* 
266 23D8 
F5 
PCHFRN 
PUSH 
PsN 
26? 
23D9 
82 
ADD 
D 
268 
23DA 
51 
/'10V 
D ..A 
269 230B 
FI 
POP 
PSt. 
210 
23DC 
CD?Al~1 
CALL 
PCHCHR 
2?/ 
23DF 
C9 
RET 
212 
* 
273 23£0 
CCC8 
RCDORG 
DBL 
0 
274 
23£2 
00 
RCDsIZ 
*** 
275 
23E3 
l~l~Ct' 
RCDPTR 
D8L 
C 
276 
23£5 
ReD8LK 
RES 
188 
277 2449 
RES 
28 
218 
EOAs/'I 
EQU 
RCD8LK+128 
279 
2465 
END 


*************************** 
*S~·N8.~L 
TABLE·'" 
**********"'**************** 


ACNT 
ADD I 
ADD3 
ADD6 
ALlST 
AS/'I2 
ASI'14 
AS/'I6AA 
BFA 


825£ 
8468 
848A 
84CA 
18R2 
It'?E 
10DC 
1/51 
8245 


ADIA 
ADDI8 
RDD3A 
ADD? 
R/'1E/'1 
AS/'12A 
RS/'/5 
ASTLlN 
BFL 


8468 
8587 
848D 
84D4 
18FE 
1098 
1//7 
1369 
8529 


ADD 
ADD II 
ADD4 
ADD9 
A08J 
RS/'13 
AS/'15A 
8ADRI 
BFLA 


8438 
85// 
849C 
84FD 
19A9 
189C 
1124 
823D 
8532 


ADD8 
9468 
ADD2 
046B 
ADD5 
8483 
ADR8IT 
8848 
AS/'1 
185E 
AS/'13R 
18Bt' 
AS/'16 
1141 
BADR2 
8241 
BFR 
8247 


BLKLIN 
1348 
CKZ89 
18D9 
CLR2 
a2F3 
CONVI 
93D7 
CRLF 
8189 
DCNT 
(~26a 
DL8 
840F 
DPOBJ3 
237C 
DTCTCC 8168 
ECH2 
16CB 
EJ3 
14RF 
EaRSM 
2465 
ERLNE 
22E2 
FRNI 
1518 
FRN8 
1599 
FRNEOS 158R 
FRSCI 
15B5 
FBR 
92RB 
FBR4 
82CE 
FDC2 
161E 
FEND 
16R5 
FHXEND 
1688 
FLCHRR 22RB 
F1'IRCD2 1461 
FOEND 
1614 
FPRMI 
0lF3 
FRMII 
8716 
FRM2 
t~640 
FRf'/6 
t~6C2 
FSRCO 
1437 
FS'r'f'/8L 
IIF6 
GOVCIN 0186 
HSRl/E 
0787 
IDIFF 
0253 
INTRf'/L 
815C 
L3 
032D 
L5R 
8370 
L5C 
a3RF 
LRCHRR 1605 
LDVCIN 
8165 
LNTH8T 
8882 
LRRCOD IFI7 
f'/NEf'/ 
07R5 
NCMPS 
1387 
NLRCHR 16D6 
NPMSG 
14FR 
NXT 
8446 
OP 
t~88E 
OPNDF 
t17R8 
OUT 
0180 
PIBI 
1757 
PIC2 
ICCI 
PIOTR2 
1888 
P I El~UR I 956 
PIINC3 
18RC 
PIORG 
188E 
PIRES2 
184D 
PI TTL2 
182F 


CFLD 
0785 
CKZRET 
18EE 
CN'v'2HX 1385 
CONVIR 
83E8 
CZ6 
18FR 
OPFDX'r' IFDR 
DLI 
8415 
DPOBJR 233C 
ERDRI 
023F 
ECHR 
16C9 
EJ4 
14CO 
EOB 
8249 
ERR 
02E8 
FRNIR 
1.'518 
FRNE2 
15R7 
FRNL'r'Z 
150F 
FRSC2 
15C7 
FBRI 
82BB 
F8R5 
t1208 
FDCENL) 164£ 
FHEX8T 
0882 
FHXOK 
1677 
FLGZ80 
IF77 
FNRSLT 
16D7 
FORMRT fJ621 
FPRf12 
0208 
FRf1I2 
071R 
FRf13 
8688 
FRM7 
0604 
FSRCD2 
1449 
FSW18T 0818 
GTPCHR 13/71 
IDC 
0lR7 
IL88813 
IF8C 
ITBL 
t1812 
LJR 
13334 
L5RI 
0384 
L6 
03CR 
LROR 
0248 
LINZ 
138C 
LP2 
148S 
LSTFLG 
13R2 
MON 
tll tl0 
NE2 
121E 
NOEND 
1218 
NSNRPS 13B5 
NXTCHR 0255 
OP8IT 
0028 
OPSRC 
t17D2 
PIRSC 
1851 
PIB2 
1768 
P/D 
1799 
PIOTR3 
189R 
PIERFL 
192£ 
PIINC4 
1882 
PIORG2 
1818 
PISUf1 
1786 
P2A 
1907 


CHI 
13783 
CLRSS 
13784 
CNVDEC a30E 
CONV2 
03EO 
CZ7 
1914 
ODFDZ2 
IFE3 
DL2 
8426 
OSRVE 
13R3 
EROR2 
8243 
ECHECK 16RO 
EJECT 
1497 
EOLROR 1324D 
ERRORS 22RE 
FRN2 
1528 
FRNENO 1691 
FRNOP 
1604 
FRSC3 
150B 
FBR2 
132CI 
F8UF 
1609 
FDEC8T 
80134 
FHXDC 
1657 
FIRST 
024F 
FLNGTH 
16C8 
FOCT 
15Ft~ 
FPI 
OIER 
FRf11 
l162C 
FRNI2R 
0729 
Ff<.'f14 
0692 
FRM8 
fJ6EB 
FSTC 
16R9 
FH'PE 
16D3 
HRNGUP IB85 
IOC2 
fJlRR 
ILC 
1888 
KB 
8262 
L4 
8JJ7 
L5RB 
0396 
L7 
8304 
LRSTIN 
£f25R 
LIST 
0311 
LP3 
147B 
LUfJP 
06R7 
MONI 
tl116 
NEGHL 
8433 
NOFILL 
187C 
NS'r'f1S 
13AO 
OBFLRG 13RI 
OPCNPI 
l1802 
OPSRCI 
070F 
PIRSC2 
185£ 
PIC 
1775 
PIOTR 
186D 
PIE 
179F 
PI INC I 
18AiJ 
PILERR 
197E 
PIQMSG 
1978 
PITITL 
1827 
P2RI 
IAI4 


CKZ2 
18FO 
CLERR 
132EB 
CNVLNO 19R13 
CPNT 
8177 
CZ8 
1921 
DELETE 
lHF2 
OPOBJ2 2368 
PSP8 IT 
138Sl1 
ECR 
22E6 
EJ2 
14R4 
ENOFNT l1752 
ERCOZ 
2208 
EUREKR 07F8 
FRN.] 
1538 
FRNEOL 
159C 
FRSC 
15BI 
FRSCBT tl028 
FBR3 
82CB 
FCFLRG 22RR 
FOECf1L 1610 
FHXDC8 
1659 
FLRG 
8259 
FNRCO 
1458 
FOCTBT l1008 
FPRM 
OIOD 
FRNI8 
078A 
FRf113 
074R 
FRf15 
86AI 
FRf'/9 
fJ6FE 
FS'r'NI 
1574 
FUNOEF 16CF 
HEX 
iJ?S9 
IDCRTH 
OICF 
INFLRG 
I.J9F 
L2 
f.f.J/2 
L'5 
iJ37R 
L58 
(f3R8 
LR8EL 
079D 
LDRSIZ 
fJ258 
LNCNT 
0238 
LPNT 
146C 
NDF8IT 
0008 
NON2 
0119 
NENSG 
1224 
NOPROG 14F 1 
NULLS 
025F 
OCOOE 
2280 
OF'Cf1PR 87FE 
ORGl/RL 
ISBR 
PIB 
1721 
PICO 
17CO 
PIOTRI 
1873 
PI Ef1SG 195tl 
PI INe2 
18A6 
PI L TBL 
ISCtl 
PIRES 
183F 
PITNP 
ISBC 
P2RIR 
IAIF 


PAGE 
76 
ZS8 
RESIoENT 
EDITOR/ASSEMBLER 


P2R2 
IC31 
P2ARS 
1ADA 
P2ASC 
1BFA 
P2RSC2 
ICIE 
P2ASC3 
IC2G 
P2ASC4 
IC2C 
P2ASCS 
IC37 
P2B 
IA35 
P28DOP 
21E5 
P2CO 
IR57 
P2CI 
ICR7 
P2C/f.l 20RB 
P2CI8B 
28Cl3 
P2CII 
21306 
P2CIIA 
28DF 
P2CI2 
2l1EB 
P2CI3 
2gF5 
P2CI4 
2!3FF 
P2CI5 
2/29 
P2CI6 
2153 
P2CI7 
218/ 
P2CI8 
21CB 
P2CIBA 
21CF 
P2CI9 
21DB 
P2CIR 
ICCE 
P2C/RA 
ICD2 
P2CIB 
ICDS 
P2C/C 
1COB 
P2C2 
ICE6 
P2C3 
IDIO 
P2C3R 
1047 
P2C3B 
ID51 
P2C3C 
IDS6 
P2C3D 
ID5E 
P2C4 
ID66 
P2C4R 
ID7L> 


P2C4B 
ID83 
P2C5 
IDC6 
P2CSRR 
IE82 
P2C5B 
IE!3S 
P2C5C 
IEgB 
P2C5D 
IEI8 
P2C5E 
IEI6 
P2CSF 
IE23 
P2C6 
IE2B 
P2C6A 
IE47 
P2C6AI 
IE4A 
P2C6B 
/E4B 
P2C6C 
IE79 
P2C6D 
IEBB 
P2C7 
IE97 
P2CB 
IER2 
P2CBA 
IEC2 
P2C8B 
IECB 
P2CBD 
IED7 
P2CBE 
IEDC 
P2CBF 
IEE3 
P2C9 
IEEB 
P2C9R 
IFtl0 
P2C9B 
IFt13 
P2CA 
IFIB 
P2CAB 
IFJS 
P2CAE 
IFJE 
P2CB 
IF49 
P2CBI 
IFS9 
P2CC 
IF8D 
P2CC2 
IFD4 
P2CD 
2831 
P2CE 
283F 
P2CE2 
20SS 
P2CF 
286E 
P2CF2 
21398 
P2CF3 
2!3AS 
P2DRTR 
IBM 
P2DBL 
IC48 
P2L>BL2 
IC6C 
P2DBL3 
IC7S 
P2DBL4 
IUR 
P2oBL5 
IC83 
P2DC 
IBEC 
P20TR2 
IBCB 
P20TR3 
IBE7 
P2DTR4 
IBF2 
P2L>TflB 18RF 
P2DTND 
18EI 
P2END 
IRD? 
P2EQU 
IR9C 
P2JTBL 
IB85 
P2LNO 
22RC 
P2LNTH 
22RF 
P2LRR 
IF09 
P2LST 
IRF7 
P20PTf<.'22£0 
P20RG 
IABI] 
P20RG2 
IRBD 
P20f.'G3 IRCC 
P2PP 
IE82 
P2PPI 
IE67 
P2PRR 
22([> 
P2PR8 
2224 
P2PRC 
2232 
P2PRCR 
225C 
P2PRD 
2263 
P2PRF 
2276 
P2PRG 
224/ 
P2PRH 
2248 
P2PRI 
2286 
P2PRNT 
21FS 
P2REt1 
IC3F 
P2RES 
IB37 
P2RESL 
IB9E 
P2F<'E5U 18B2 
P2RSUF 
IB93 
P2TCR 
IFtlF 
P2TPP 
IE54 
P2UNL 
IRFO 
P2UNLA 
IAFI 
PURER 
21321 
P2ZDER 
2029 
P2ZL2 
28l1B 
P22LER 
2086 
P2ZRER 
2019 
P2ZUER 
2011 
PRGE 
1388 
PRSSI 
I?OF 
PASS2 
19C6 
PCHBL2 
22FA 
PCHBL3 
2301 
PCHBLT 
22FI 
PCHCHR 
l117R 
PCHFRN 
23D8 
PCHOB2 
2327 
PCH083 
23313 
PCHOBJ 
2312 
PCHRES 
238D 
PCHRS2 
23B8 
PCHRS3 
23CC 
PDI 
13C2 
PD2 
13C3 
PDVC 
0(100 
PDVINT 
0162 
PFCH 
OIDO 
PFLRG 
l125D 
PGNS 
14C:~ 
PGN81 
14D2 
PGN82 
14DB 
PGNO 
13BO 
PRFLRG 
13RO 
PRT 
13199 
PRT2 
019C 
PS'TI 
12E3 
PS~'2 
12FO 
PS~'2R 
12FB 
PS~'3 
12FD 
PS'TEND 
1330 
PS~'LN 
1341 
PS~'MTB 
1288 
PTRLR 
2298 
PUNCH 
03t19 
R2 
0550 
R3 
OSF6 
R3R 
8SFR 
R4 
l16f.1D 
RS 
0616 
R6 
OSSO 
RCDBLK 
23ES 
RCDORG 
23EO 
RCDPTR 
23E3 
RCDSIZ 
23E2 
RCH 
0599 
RCH2 
llS86 
F,'DPMSG IISE 
RORINT 
OISF 
RDRSTP 
016E 
RDRSTT 
(.jIGB 
READ 
8S3E 
REBIT 
l1010 
REWIND 
el83 
RKB 
gl?O 
RSLNTH 
22EF 
RSTRD 
IIFt1 
RTMON 
22R4 
RTNFLG 
0786 
F.'TR 
85CS 
F:1RB 
llSD6 
RTRCZ 
05E2 
SB 
0174 
SDF,'F 
ID8E 
SDRFB 
IDBI 
SDRFC 
IDC4 
SDf:FD 
10AE 
SE2 
1/~~2 
SECOND 
8251 
SKEL 
1;1785 
SLL2 
16F2 
SLL3 
/708 
SLLBL 
16DF 
SPTR 
13R? 
SPTR2 
/3R9 
SRCP1R 
13B:~ 
SRCSTB 
IIBO 
SRF 
IC88 
SRF/ 
/C9tl 
SRF2 
IC98 
SRFILE 
IC9F 
SRST/ 
IIC6 
SRST2 
IIDI 
SRT2A 
/278 
SRTST 
1239 
SRTsm 
/242 
SRTSTI 
/254 
SRTST2 
1265 
SRTST3 
/29C 
SRTSNP 
128J 
STBMSG 
134D 
STFILL 
/B73 
STLOC 
13R5 
STMT 
liEF 
STO 
IIFF 
STOf1 
/205 
STPCOD 
IFIS 
SVRL 
13R8 
SImp2 
128A 
S'r'MBIT t1004 
S~'f1CNT /383 
S~'ME:NT 1171 
S~'NLOC 
13RF 
S'TNPTR 
/38/ 
TBUF 
13EF 
TCRCOD 
/F19 
TCHKI 
/FE:5 
TCHK2 
IFF2 


423 


TENP 
t1257 
TRLSIZ 
B25C 
XCLI 
8773 
Xf'lTTLE 
8768 
ZHEX 
/393 


TITLE 
TSIZE 
xeUNE 
XOP 
ZL?C/ 


/3C8 
13/62 
l~76E 
867/ 
IFFE 


TLFLRG 
188E 
UNDF8T 
l~88/ 
XI'1TTL 
l~759 
XOPI 
l~678 
ZL 7C2 
2t1t18 


TR 
KCF 
XNTTL2 
ZH2 
ZL7CHK 


065F 
1373.5 
(1;'5£ 
/39C 
IFF4 


APPENDIX C I 
THE ZEDBUG 
DEBUGGING 
MONITOR 


When the ZEDBUG 
object tape has been loaded successfully 
as 
per the instructions 
in appendix 
A it must be initialized 
to operate 
with your peripheral 
configuration. 
This appendix describes the nec- 
essary steps in this initialization. 
The ZED BUG monitor 
will perform all of its functions with as lit- 
tle peripheral 
equipment 
as a Teletype, though it is capable of taking 
advantage 
of other peripherals 
if they are available. 
The initializa- 
tion consists of supplying a series of up to eleven input/output 
rou- 
tines, beginning 
at memory 
location 
:3E70 after the end of ZED- 
BUG proper, 
and filling in a jump 
table which begins at location 


:3660 within ZEDBUG. 
The program 
itself begins at location 
:3600, 
allowing operation 
within a 16K machine. 
If more memory is availa- 
ble the program can be easily reassembled 
on any required origin. 
Each of the eleven possible 
I/O 
routines 
must be in subroutine 
form, i.e., it must end with a RET instruction 
(:C9). If a routine is 


not required either because the peripheral 
it services does not exist in 
your system or because its function 
is irrelevant 
it may simply be ig- 
nored, 
though 
the corresponding 
position 
in the I/O 
jump 
table 
must be filled in with a RET instruction. 
In a system equipped 
only 
with an ALTAIR or IMSAI style Teletype without reader control five 
of the eleven routines 
become meaningless. 
The routines 
and their 
functions 
are: 


GTFRM 
Read one tape frame from the paper tape read device 
and return with the frame read in the A register. Disturb 
no other registers. 


RKB 
Read one character 
from the terminal 
keyboard 
and 
return with it in the A register. The character must be in 
upper case ASCII with the high bit forced on. Upper 
case ASCII can be forced by testing the character 
for 
the :El - :FA range after the high bit is forced to one. If 
the character is in this range execute ANI 
:DF. Disturb 
no register other than A. 


OUT 
Print 
the character 
in the A register on the system 
terminal device. Wait for the character to clear and then 
return with no register disturbed. 


PCHCHR 
Send the character in A to the paper tape punch. Return 
with no register disturbed. 


DTCTCC 
Detect control-C typed. If control-C was typed return 
with the carry bit on. If no character was typed or if 
something other than control-C was typed return with 
carry off. Do not wait for something to be typed, sim- 
ply test to see whether 
something 
has already 
been 
typed. Only A may be changed. The code for control-C 
is 8316• 


SB 
Wait for space bar. Wait until a character 
is typed. 
Return when the space bar code (AOI6) is typed. If some- 
thing other than space is typed ignore it and continue to 
wait for the space. Do not echo the character 
typed, 
space or otherwise, to the terminal. 


When the above routines have been entered into memory begin- 
ning at :3E70 the jump table at :3660 must be filled in, in the order 
shown below. If a routine does not exist, fill in the three word jump 
table entry with C9 00 and 00. A jump instruction is C3. When fill- 


ing in the jump address, remember that the low order half of the ad~ 
dress occupies the low order memory word. If the INTMNL routine 
began at :3E70 the 3 word jump table entry at :3660 would be: 


3660 
C3 
3661 
70 
3662 
3E 


address 
3660 
3663 
3666 
3669 
366C 
366F 
3672 
3675 
3678 


'3678 
367E 


instruction 
JMP 
INTMNL 
JMP 
INRDR 
JMP 
GTFRM 
JMP 
RDRSTT 
JMP 
RDRSTP 
JMP 
RKB 
JMP 
OUT 
JMP 
PDVCIN 
JMP 
PCHCHR 
JMP 
DTCTCC 
JMP 
SB 


This process is really a good deal simpler than it looks. For a sys- 
tem with only a Teletype without reader control the table looks like 
this: 


3660 
RET 
irrelevant 
DBL 
0 
fill with zeros 
3663 
RET 
irrelevant 
DBL 
0 
fill with zeros 
3666 
JMP 
GTFRM 
get paper tape frame 
from TTY reader 
3669 
RET 
irrelevant 
DBL 
0 
fill with zeros 
366C 
RET 
irrelevant 
DBL 
0 
fill with zeros 
366F 
JMP 
RKB 
get character from 
keyboard 


3618 
367E 
JMP 
JMP 
DTCTCC 
SB 


print character in A 
irrelevant 
fill with zeros 
punch character. For 
this simple configura- 
tion print and punch are 
the same. 
detect control-C 
wait for space bar 


3672 
3675 
JMP 
RET 
DBL 
JMP 
o 
OUT 


As a guide to initializing for more elaborate sets of peripherals, the 
ZEDBUG initialization 
for the writer's system is shown in assem- 
bled form immediately before the ZED BUG assembly listing in this 
appendix. 
When all of the above adjustments 
are made, transfer control to 
the first location 
of ZEDBUG, 
:3600. It should respond with a 
prompt character (#). If it does not there is some error in your I/O 
routines or in the jump table. Go back and correct it. When ZED- 
BUG responds with the prompt, type 


Where nnnn is the last location used by your I/O routines. The com- 
puter will pause while you turn on the punch device. Strike the space 
bar and initialized copy of ZEDBUG, complete with your I/O rou- 
tines will be punched on the system punch device. If this is not suc- 
cessful there is some error in your punch service routines. 
You may now use the ZEDBUG load command (L.) to load the 
object copy of the assembler. Put the tape in the reader and type L. 
The period after L is part of the command. If the tape reader must 
be manually started, as with a Teletype without reader control, set 
the switch to the start position. 
The tape should begin running 
through the reader. If it does not, there is something wrong with 
your INRDR or RDRSTT routines. 
When the tape has finished passing through the reader it should 
stop if you have reader control, and one of two things will happen. 
Either a prompt character (#) will appear, meaning that the load is 
successful or the word: 


will appear, 
meaning that an error has occurred. 
If you get the 
CKSM message either there is an error in your GTFRM routine or a 
hardware malfunction exists in the paper tape reader. It is also possi- 
ble that the tape has become dirty through dragging on the floor dur- 
ing the load process. If your system has no reader control the tape 
will continue to slew through 
the reader. 
On a Teletype this will 
cause a series of meaningless "?" characters to be printed. This does 
no harm and is due to the fact that the computer cannot tell whether 
the character it is seeing is from the reader or the keyboard. It is ex- 
pecting input from the keyboard and the null frames still being read 
from the tape constitute illegal commands. The "?" is ZEDBUG's 
way of protesting an illegal command. 
If your system is equipped with a disk, now is the time to copy 
ZED BUG to the disk. This will save the tedious job of reinitializing 
if tapes are lost or destroyed. As with any important 
piece of soft- 
ware, make a backup copy. 
You are now ready to initialize the assembler in appendix B. 


8i~2 
003 
i~84 
a05 
a86 
007 
8a8 
€tf.l9 
8/0 
all 
8/2 
a/3 
8/4 
8/5 
3660 C3783E 
i~/6 3663 C3793E 
Ell? 3666 C38FJE 
0/8 
3669 C3973E 
0/9 
366C 
C39C3E 
020 
366F 
C3A/3E 
82/ 
36?2 C3843E 
822 3675 C3BF3E 
023 3678 C3Di13E 
824 
367B 
C3EA3E 
825 
367E 
C3FA3E 
026 
827 
828 
i~29 
83i~ 
t"'3/ 
832 
833 
834 
835 3E7t'" 3E83 
836 3£72 D328 
837 
3E74 
3E // 
038 
3E76 
D32i~ 
i139 3E78 
C9 
848 
84/ 
842 
tN3 
044 
3E79 
AF 
t"'45 3E7A 
D3/ i~ 
846 
3E7C 
D3/2 
847 
3E7E 
D3/3 
848 
3E80 
3D 
849 
3E8/ 
D3// 
858 
3E83 
3E94 
85/ 
3E85 
03/0 
852 
3E87 
3E86 
053 
3£89 
D3/2 
854 
3E88 
CD9C3E 
i~55 3E8E 
C9 
856 
857 
858 
3E8F 
D8/2 
i~59 3E9/ 
/7 


** I/O 
ROUTINES 
FOR 
THE 
t~RITER'S 
SYSTE/'t 
* SL~PORTING 
THE 
FOLLOUING 
PER IPHERRLS, 
** / - CRT 
TER/'tINAL 
* 2 - 
RE/'tEXHIGH 
SPEED 
TAPE 
READER 
* 3 - RE/'tEXHIGH 
SPEED 
TAPE 
PUNCH 
* 4 - OKIDATA 
LINE 
PRINTER 
* 


ORG 
'3668 
J/'tP 
IN T/'tNL 
J/'tP 
INRDR 
J/'tP 
GTFR/'t 
J/'tP 
RDRSTT 
J/'tP 
RDRSTP 
J/'tP 
RKB 
J/'tP 
OUT 
J/'tP 
PDVCIN 
J/'tP 
PCHCHR 
J/'tP 
DTCTCC 
J/'tP 
S8 


I/O 
S£F,'VICE ROUTINES 


THESE 
ROUTINES 
/'tA~'BE 
IN AN~' 
ORDER 
BUT 
THEY 
/'tUSTBEGIN 
BEYOND 
THE END 
OF 
ZEDBUG 
ITSELF 
(, 3E60 


INITIALIZE 
PAPER 
TAPE 
READER 
INTERFACE 


READ 
ONE 
TAPE 
FRA/'IEAND 
RETURN 


INT/'tNL /'tVI 
OUT 
/'tV I 
OUT 
RET 
STAT 
El~U 
DATA 
El~U 


A,3 
STAT 
A.,' // 
STAT 


INRDR 
ZAR 
OUT 
CTLA 
OUT 
CTLB 
OLIT 
DTAB 
DCR 
A 
OUT 
DTAA 
/'IVI 
A,4 
OUT 
CTLA 
/'IVI 
A,6 
OUT 
CTLB 
CALL 
RDRSTP 
RET 


GTFR/'t 
IN 
CTLB 
RAL 
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PRGE 
82 
I/O 
RSSIGNMENTS 
FOR 
ZEDBUG 


860 
3E92 
30F8 
$ 
8NC 
GTFR/'I 
861 
3E94 
0813 
IN 
DTR8 
1362 3E96 
C9 
RET 
863 
1364 
865 
3E97 
3E8F 
RDRSTT 
/'IVI 
R ..GOB ITS 
STRRT 
PRPER 
TRPE 
t"l66 3E99 
D31 I 
OUT 
DTRR 
RERDER 
867 
3E98 
C9 
RET 
068 
869 
070 
3E9C 
3EFt'l 
RDRSTP 
/'IVI 
R,STP8TS 
STOP 
PRPER 
TRPE 
871 
3E9E 
D311 
OUT 
DTRR 
RERDER 
072 
3ER0 
C9 
RET 
073 
074 
CTLR 
EQU 
'18 
PRPER 
TRPE 
RERDER 
075 
DTRR 
EQU 
CTLR+I 
DEVICE 
RDDRESS 
t"l76 
CTL8 
EQU 
DTRR+I 
DEFINITIONS 
877 
DTRB 
EliU 
CTLB+I 
t17S 
G08ITS 
EQU 
'F 
079 
STP8TS 
EQU 
'F8 
080 
881 
1382 3ERI 
D82t"l 
RK8 
IN 
STRT 
RERD 
ONE 
CHRRRCTER 
883 
3EA3 
IF 
RAR 
FRO/'lTER/'IINRL 
l'l84 
3ER4 
3t"lFB 
$ 
BNC 
RkB 
KH'80RRD 
RND 


t"l85 3ER6 
D82/ 
IN 
DRTR 
ECHO 
BRCK 
TO 
1386 3ER8 
F680 
ORI 
:80 
TER/'IINAL. FORCE 
887 
THE 
HIGH 
8IT 
TO ONE. 


t188 
3ERA 
FEEl 
CPI 
'EI 
CHECK 
FOR 
LOWER 
089 
O3EAC 3886 
$ 
8LS 
OUT 
CRSE 
RSCII 
09t"l 3EAE 
FE78 
CPI 
:18 
l'!913EBl'!O38l'l2 
$ 
BGE 
OUT 
1392 3E82 
E6DF 
RNI 
'DF 
ZRP 
LOWER 
CRSE 
BIT 
893 
t"l94 
895 
O3EB4 D0321 
OUT 
OUT 
DRTA 
SEND 
CHRRRCTER 
l'l96 
3EB6 
F5 
PUSH 
PSW 
IN A 
TO 
TER/'IINRL 
097 
3E87 
D820 
OUT2 
IN 
STAT 
1398 O3E89 IF 
RRR 
899 
3EBR 
IF 
RRR 
/013 O3EB8 313FR 
$ 
8NC 
OUT2 


10/ 
3EBO 
FI 
POP 
PSI. 
RETURN 
WITH 
R 
102 
O3EBE C9 
RET 
UNCHRNGED 
Il'13 
104 
/l'!5 
3EBF 
AF 
PDVCIN 
ZRR 
INITIRLIZE 
PRPER 
106 
3EC13 D314 
OUT 
CTR 
TRPE 
PUNCH 
W7 
3EC2 
0316 
OUT 
CTe 
INTERFRCE 
108 
3EC4 
3D 
DCR 
R 
189 
O3EC5 D317 
OUT 
OT8 
I113 3EC7 
3E04 
/'IVI 
R,4 
III 
O3EC9 D3/4 
OUT 
CTR 
112 
3ECB 
O3E036 
/'IVI 
R ..';,6 
1/3 
3ECD 
D316 
OUT 
GT8 
114 
3ECF 
C9 
RET 
115 
116 
117 
3ED8 
D3/7 
PCHCHR 
OUT 
DTB 
PUNCH 
FRRME 
IN R 
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118 3ED2 
D815 
119 3ED4 
E681 
120 3ED6 
20FA 
121 3ED8 
3E3E 
122 3EDA 
D316 
123 3EDC 
3E36 
124 3EDE 
D316 
125 3EEe 
DBI? 
126 3EE2 
D816 
12? 3EE4 
I? 
128 3EE5 
30F8 
129 3EE? 
DBI? 
138 3EE9 
C9 
131 
132 
/33 
134 
135 
136 
13? 3EEA 
DBZt1 
138 3EEC 
IF 
139 3EED 
D13 
14l~ 
141 3EEE 
D821 
142 3EFt1 F6813 
143 3EF2 
FE83 
144 JEF4 
2882 
145 3EF6 
3? 
146 JEF7 
C9 
147 JEF8 
87 
148 3EF9 
C9 
149 
150 
151 3EFR 
D820 
152 3EFC 
IF 
153 3EFD 
3(~F8 
154 3EFF 
DB21 
155 3F13I F68l~ 
156 3F(;13FEA13 
157 JFl~5 213F3 
158 3F07 
C9 
159 3F13S 


PCH2 
IN 
RNI 
$ 
8NZ 


/'110'1 
OUT 


/'110'1 
OUT 
IN 
PCH3 
IN 
RRL 
$ 
BNC 
IN 
RET 
eTR 
EQU 
DTA 
EQU 
CT8 
EQU 
DTB 
EQU 


DTCTCC 
IN 
RRR 
RNC 


IN 
ORI 
CPI 
$ 
BNE 
5TC 
RET 
DTCT2 
R5C 
J.~ET 


58 
IN 
RRR 
$ 
BNC 
IN 
ORI 
CPI 
$ 
8NE 
RET 
END 


*************************** 
*S'r'/'I80L 
TABLE* 
*************************** 


CTA 
DATA 
DTB 
GTFRI'/ 
OUT2 
PD VC IN 
5B 


IWI4 
t1021 
81317 
3E8F 
3E87 
3EBF 
JEFA 


CTB 
DTA 
DTCT2 
INRDR 
PCH2 
RDR5TP 
STRT 


0016 
0815 
3EF8 
3E79 
3ED2 
3E9C 
(1020 


DTR 
'81 
PCH2 
R.. '3E 
CT8 
R.. '36 
CTB 
DT8 
CTB 


PCH3 
DT8 


, 14 
CTA+I 
DTR+I 
CTB+I 


DRTR 
:8tl 
'83 
DTCT2 


5TRT 
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DATA 
'8(~ 


S8 


CTLR 
130W 
DTAA 
0011 
DTCTCC 
JEEA 
INTI'/NLJE10 
PCK? 
3EE2 
'<:DRSTTJE97 
5TPBTS 
80FB 


PUNCH 
DEVICE 
RDDRESS 
RSSIGNI'/ENTS 


DETECT 
CONTROL-C 


RETURN 
II'/I'/EDIRTEL¥ 
IF NOTHING 
H'PED! 


FORCE 
HIGH 
BIT 
ON 


CRRRY 
ON 
IF CONTROL-C 
H'PED ..RETURN 
CARR't'OFF 
OTHERWISE 


WAIT 
FOR 
5PRCE 
BAR 


DO NOT 
RETURff 
UNTIL 
SPRCE 
IS 
TYPED 


CTLB 
13012 
DTAB 
t1013 
GOB ITS 
88(~F 
OUT 
3EB4 
PCHCHR 
3EDO 
RKB 
JERI 


Except as noted below, all numbers typed in by the user are hexa- 
decimal. The symbol @ is used below to indicate a space typed by 
the user. The symbols aaaa and bbbb indicate 4 digit hexadecimal 
numbers, nn and dd are two digit hexadecimal numbers. The symbol 
rp means the higher register of a register pair. 


Examine location aaaa. If nn is typed in response 
the contents of aaaa will be changed to nn. TYP- 
ing space displays the next higher memory ad- 
dress, typing comma the next lower memory ad- 
dress. A period terminates the command. A hex- 
adecimal number typed before the period, blank 
or comma replaces the contents of aaaa with the 
typed number. 


Displays the entire block aaaa through bbbb on 
the system terminal device. 


Displays contents of the last item pushed onto 
the user stack. Space bar and comma works as 
for Maaaa above. 


Causes interrupts 
to be disabled or enabled 
during execution of jump or breakpoint com- 
mands. 


Display pseudo register pair rp. Contents of rp 
are changed by typing a hexadecimal value. 
Command terminates with a period. 


Display pseudo A register. Modification as for 
Rrp above. 


Displays individual bits of the pseudo F register. 
Bits are changed by typing name of bit, S, Z, A, 
V, N or C followed by one or zero. Period ter- 
minates the command. 


Display/modify prime pseudo F register, as for 
RF@above. 


Load assembler-generated object tape or output 
of D command below from the system tape read- 
er. Error in load generates the message CKSM. 


Punch memory addresses aaaa through bbbb 
onto paper tape. The punching is preceded and 
followed by a pause to turn punch device on and 
off. Space bar resumes activity. 


Load machine registers from pseudo registers 
and transfer control to location aaaa. 


Sets a 
breakpoint 
at 
bbbb, 
loads 
machine 
registers from pseudo registers and transfers 
control to aaaa. Upon return from breakpoint 
all pseudo registers are reset to values of machine 
registers, then typed out as for R. command 
above. If control does not return stop the com- 
puter, set PC to beginning of ZEDBUG and 
start. 
This will clear the breakpoint 
in the 
program being tested and product the BKPT 
FAILED message. 


Faaaa@bbbb@nn. Fills locations aaaa through bbbb with the value 
nn. Value of aaaa must be less than that of bbbb. 


Saaaa@bbbb@nn. Searches locations aaaa through bbbb for the 
value nn. Addresses of locations containing nn 
are displayed on terminal device. 


Reads device address nn and displays result. 
Space bar repeats the read and display. Period 
terminates the command. 


Output 
the data 
dd to device address 
nn. 
Space repeats the output. Period terminates the 
command. 


002 
003 
004 
tlt15 
8@6 
l187 
8@8 
tl@9 36l1tlF3 
@18 3681 310036 
8 II 3684 CD6836 
812 36t17 CD6336 
tll3 36tlACD7536 
814 368D 3A4939 
@15 3618 B7 
8/6 3611 C2CF39 
tl/73614 CD7637 
818 36/7 
3EA3 
@19 3619 CD7236 
@2@ 361C CD6F36 
t121361F FECD 
822 
362/ 
CAB236 
023 
3624 FEAF 
024 
3626 
CA393A 
825 
3629 FED2 
@26 362B CA573A 
@27 
362£ F£CC 
828 
3638 
CA233C 
029 3633 FEC4 
838 
3635 
CA8A3C 
@31 3638 FECA 
032 363A CA0439 
033 363D FEC2 
834 363F CA7339 
t135 3642 FEC6 
836 
3644 
CRE83D 
837 
3647 FED3 
@38 
3649 
CAF73D 
039 364C FEC9 
@48 364E CRDR38 
041 3651 FECF 
13423653 
CRFE38 
t143 3656 
3E8F 
@44 
3658 
318036 
l145 365B CD7236 
l146 365E 
1884 
847 
848 
849 
0511 3660 
C36836 
051 3663 
C36336 
l152 3666 C36636 
l153 3669 C36936 
1354366C C36C36 
t155 366F C36F36 
056 3672 
C37236 
l157 3675 
C37536 
@58 
3678 
C37836 
1359367B C37B36 


******************************************* 
* HEXRDECII'IRLDEBUG FOR Z88 8RSED S~'STEI'1S 
* 
******************************************* 
** 
14.14.6/23/78 
* 
ORG 
ZEDBUG 
DI 
LXI 
CRLL 
CRLL 
CRLL 
LDR 
ORR 
JNZ 
RESUI'1E CALL 
NVI 
CALL 
CRLL 
CPI 
JE(~ 
CPI 
JE(~ 
CPI 
JEQ 
CPI 
JEQ 
CPI 
JEQ 
CPI 
JEQ 
CPI 
JEQ 
CPI 
JEQ 
CPI 
JEQ 
CPI 
JEQ 
CPI 
JEQ 
TILT 
NIII 
LXI 
CRLL 
8RA 


KILL 
SP..ZEDBUG 
INTI'1NL 
INRDR 
PDVCIN 
ILOC 
A 
BPFRIL 
CRLF** 
R.. "II" 
OUT*** 
RK8*** 
'1'1' 
INS 
,/' 
IE'R' 
R'L' 
LOADER 
'D' 
DUI'1P 
,J' 
JUI'1P 
'B' 
XEQ 
'F' 
FILL 
'·S' 
SERRCH 
'I' 
INPUT 
'0' 
OUTPUT 
R~"?'" 
SP,ZEDBUG 
OUT*** 
RESUNE 


INTI'1NL 
INRDR 
GTFRN 
RDRSTT 
RDRSTP 
RKB*** 
OUT*** 
PD~'CIN 
PCHCHR 
DTCTCC 


CHECK FOR BRERKPO INT ON 
CLERR THE BREAKPOINT 
RETURN CRRRIRGE 
SEND PRONPT CHRRACTER 


INITIRLIZE 
TERI'1INAL 
INITIALIZE 
TRPE RERDER 
GET FRAME FRON READER 
START READER 
STOP READER 
READ TERf1INRL KEYBOARD 
SEND CHAR. TO TERNINRL 
INITIALIZE PUNCH 
PUNCH FRANE IN A 
DETECT CONTROL-C 


** I/O VECTOR 
*INTI'1NLJI'1P 
INRDR 
JMP 
GTFRN 
JNP 
RDRSTT 
JI'IP 
RDRSTP 
JI'1P 
RKB*** 
JNP 
OUT*** 
JMP 
PD~'CIN JMP 
PCHCHR 
JNP 
DTCTCC 
JMP 


060 
367E 
C37E36 
061 
062 
1:.163 
064 
3681 
FED3 
1:.1653683 
28DI 
066 
3685 
CD6F36 
t167 3688 
FERE 
068 
368R 
2aCA 
(169 368C 
2R3E39 
13713368F 
CD7637 
1371 3692 
7E 
872 
3693 
47 
fJ73 3694 
23 
1374 3695 
7E 
(175 3696 
CDCD38 
876 
3699 
78 
877 
369R 
CDCD3B 
878 
369D 
2B 
879 
369E 
CD6F36 
1381336RI 
FERE 
1:.18136R3 
CA 1436 
1382 36A6 
FEAC 
1383 36R8 
2884 
1384 36AA 
23 
e85 36RB 
23 
e86 36AC 
18EI 
887 
36RE 
2B 
e88 36RF 
2B 
e89 36B8 
18DD 
890 
891 
892 
893 
36B2 
CDDB3D 
894 
36B5 
28CA 
895 
36B7 
FEA8 
896 
36B9 
CA663D 
897 
36BC 
FERE 
898 
36BE 
C25636 
ll99 
36CI 
CD7637 
lel3 
36C4 
7C 
181 36C5 
CDCD3B 
le2 
36C8 
7D 
183 
36C9 
CDCD3B 
1134 36CC 
3EA13 
/85 36'CE CD7236 
1136 36DI 
7E 
187 
36D2 
CDCD3B 
188 3605 
3ER8 
109 
36D7 
CD7236 
1113 36DA 
226737 
11I 36DD 
CDDB3D 
I 12 36E13 21386 
I13 36E2 
2R6?37 
114 
36E5 
C3FD36 
115 36E8 
3A6637 
I16 36EB 
FER8 
I I 7 36ED 
2889 


58 
** EXAMINE 
STACK 
CONTENTS 
*CSTRCK 
CPI 
BHE 
CALL 
CPI 
BNE 
LHLD 
C5TK2 
CALL 
MOV 
MOV 
INX 
MOV 
CRLL 
MOV 
CALL 
DCX 
CRLL 
CPI 
JEQ 
RESUME 
CP I 
/, / 


BNE 
CSTK3 
INX 
H 
INX 
H 
$ 
BRA 
CSTK2 
CSTK3 
DCX 
H 
DCX 
H 
BRA 
CSTK2 
** MEMOR't' INSPECTION/MODIFICRTION 
f'/ACHINER'r' 


*INS 


/5/ 
TILT 
RKB*** 


TILT 
STKP 
CRLF** 
A,M 
B.oA 
H 
A,1'1 
P/ol 
R,B 
P/ol 
H 
RKB*** 


CALL 
BZ 
CPI 
JEG! 
CPI 
JNE 
CALL 
1'10V 
CRLL 
/'/0 V 
CRLL 
1'1VI 
CALL 
1'10V 
CRLL 
1'1VI 
CRLL 
SHLD 
CRLL 
BNZ 
LHLD 
J1'1P 
LDR 
CPI 
BEG! 


TILT 
CRLF** 
A,H 
P/ol 
A.oL 
PW 
R.o;' 
" 


OUT*** 
R,M 
P/ol 
A.o·' 
/ 


OUT*** 
SAVE 
FPRM 
INS3 
SR~'E 
MRYBE 
LRSTIN 


INS3R 


RETURN 
CRRRIAGE 
MOVE 
HIGH 
ADDRESS 
CONVERT 
AND 
PRINT 
CONVERT 
LOW 
ADDRESS 
CONVERT 
AND 
PRINT 
PRINT 
BLANK 


GET 
1'1E1'10R'r' 
CONTENTS 
CONVERT 
RND 
PRINT 


I18 36EF 
FERC 
119 
36FI 
2805 
120 
36F3 
FERE 
121 
36F5 
C25636 
122 36F8 
7D 
123 
36F9 
2R6737 
124 
36FC 
77 
125 36FD 
3R6637 
126 37&& 
FER& 
127 37&2 28&3 
128 3784 23 
129 3785 
18BR 
138 3707 
FERC 
131 3789 
C21436 
132 
370C 
28 
133 
378D 
C3CI36 
134 
135 
136 
137 371 tl 2/tl8tltl 
138 3713 
54 
139 
3714 
44 
148 
3715 
CD4637 
14/ 
3718 
DB 
142 
3719 
29 
143 371R 
29 
144 3718 
29 
145 
371C 
29 
146 
371D 
5F 
147 
37/E 
19 
148 
371F 
04 
149 3728 
18F3 
150 
15/ 
152 
/53 
154 3722 
324437 
155 3725 CD3937 
156 3728 
3245."37 
/57 372B 
3R4437 
158 
372E 
IF 
159 
312F 
IF 
160 3738 
IF 
161 
3731 
IF 
162 3732 
CD3937 
163 3135 324437 
/64 3738 
C9 
/65 3739 
E68F 
166 3738 
FEllR 
167 373D 
3882 
168 
373F 
C607 
169 
3741 
C6B8 
170 
3743 
C9 
171 
3744 
172 
173 
174 
175 


CPI 
BEa 
CPI 
JNE 
110V 
LHLD 
110V 
LDR 
CPI 
BNE 
INX 
BRR 
CPI 
JNE 
DCX 
HIP 


INS3R 


TILT 
R..L 
SRVE 
11.. R 
LRSTIN 


INS2 
H 
INS/ 


RESUI1E 
H 
INSI 


GET 
EXIT 
CHRRRCTER 
NEXT 
LOCATION? 


YES, 
BUNP 
POINTER 
AND 
DO 
IT 
BACK 
UP 
ONE 
LOCATION·:> 
NO 
ABORT 
YES ..DO 
IT 


** FETCH 
HEXADECINAL 
STRING 
FROPt KEYBOARD 
*FHSTR 
110V 
NOV 
CALL 
RC 
DAD 
DRD 
DAD 
DAD 
110\1 
DAL> 
INR 
BRA 


D,H 
B ..H 
FHCH 


H 
H 
H 
H 
E ..A 
D 
B 
FH/ 
** CON~'ERT 
A REGISTER 
* CHARACTERS 
LEFT 
IN 
*CNV2HX 


ZERO 
D FOR 
DOUBLE 
ADD 
AND 
B FOR 
DIGIT 
COUNT 
GET 
HE.".'CHARACTER 
RETURN 
IF NOT 
HEX 


SHIFT 
LEFT 
FOUR 
BITS 
VER'r'.-VER'r' 
LABOR IOUSL 'r' 


INPUT 
CHARACTER 
TO E 
FORI1 NEW 
SUN 
BUI1P DIGIT 
COUNT 


SAVE 
INPUT 
NUNBER 
CONI/ERT 
LOW 
FOUR 
BITS 
SAVE 
IT 


NOVE 
IT RIGHT 
FOUR 
BITS 
VER'r',VER'r' 
LABOR IOUSL 'r' 


AND 
RETURN 
CLEAR 
UPPER 
FOL~ 
BITS 
A-F? 
NO 
'r'ES 
ADD 
ZONE 
BITS 


CN 
** FETCH 
ONE 
HEX 
CHARACTER 
FROI1 kEYBOARD 
* IF 
THE 
CHARACTER 
WAS 
LEGAL 
HEX 
THE 
CARRY 
* BIT 
RETURNS 
OFF. 
IF 
IT WAS 
NOT 
THE 
CARR'r' 


STA 
CALL 
STA 
lOR 
RAR 
RAR 
RAR 
RRR 
CALL 
STR 
RET 
ANI 
CPI 
BLS 
RDI 
RD! 
RET 
RES 


CN 
ZHEX 
CN+/ 
CN 


ZHEX 
CN 


'F 
/0 
ZH2 
7 
'B8 


176 
* BIT 
RETURNS 
ON. 
177 
* 
178 
3746 
C06F36 
FHCH 
CRLL 
RK8**'1' 
GET 
TYPED 
CHRRRCTER 
179 
3749 
326637 
STR 
LRSTIN 
SRVE 
IT 
188 
374C 
FE8& 
CPI 
'B8 
LESS 
THRN 
'B&? 
181 
374E 
3811 
$ 
BLS 
STC 
182 
3758 
FEBR 
CPI 
'BR 
GRERTER 
THRN 
97 
183 
3752 
38tlR 
$ 
BLS 
STRIP 
184 
3754 
FECI 
CPI 
'R' 
IN 
R-F'RRNGE? 
185 
3756 
38@9 
$ 
BLS 
STC 
186 
3758 
FEC7 
CPI 
'G' 


187 
375R 
3885 
$ 
BGE 
STC 
188 
375C 
OE86 
S8I 
6 
YES ..BIRS 
OOI4N 
189 
375E 
E6fJF 
STRIP 
RNI 
'F 
CLERR 
UPPER 
4 BITS 
RND 
CRRR~' 
198 
3760 
C9 
RET 
191 
3761 
37 
STC 
STC 
192 
3762 
3R6637 
LDR 
LRsTIN 
PICK 
UP 
INPUT 
CHRR. 
193 
3765 
C9 
RET 
RNO 
RETURN 
WITH 
CRRR~' ON 
194 
3766 
&& 
LRSTIN 
**'1' 


195 
3767 
SRVE 
RES 
2 
196 
* 
197 
3769 
CD7637 
PRT'1''1'·'" 
CRLL 
CRLF'1''1' 


198 
376C 
7E 
PRT2** 
1'101' R ..M 
199 
376D 
23 
INX 
H 
280 
376E 
FEDC 
CPI 
'\ ' 


281 
377t~ C8 
RZ 
2&2 
3771 
CD 7236 
CRLL 
OUT'1'** 
283 
3774 
18F6 
$ 
BRR 
PRT2·"''1' 
2&4 
* 
285 
3776 
3E80 
CRLF'1''1't1"'I 
R ..'80 
286 
3778 
CD 7236 
CRLL 
OUT'1''1''1' 
2@7 
377B 
3E8R 
l'1'v'I R ..'SR 
2t~8 377D 
CD?236 
CRLL 
OUT'1'*'1' 


209 
37811 3EFF 
~1'v'I R ..'FF 
2/fJ 3782 
CO 7236 
CRLL 
OUT'1''1'* 
2/1 
3785 
C9 
RET 
212 
3786 
8& 
TEt1P*'1' *'1'* 
213 
* 
214 
* REGISTER 
EXRt1INE.····MOO 
I F'r' 


215 
* 
216 
3787 
C06F36 
RR 
CALL 
RK8*** 
2/1378A 
213339 
LXI 
H ..A 
218 
3780 
FERf3 
CPI 
2/9 
378F 
280C 
$ 
BEQ 
AR/ 
220 
3791 
FER 7 
CPI 
:R7 
22/ 
3193 
2822 
$ 
BNE 
ARTIL T 
222 
3795 
2/2839 
LXI 
H ..A' 


223 3798 
3ER8 
t1'v'I A.- 
..' 
" 
224 
319R 
C07236 
CRLL 
OUT**'1' 


225 
319D 
22CI37 
RR/ 
5HLD 
RADR 
226 
37Rt~ 7E 
t10'v' R ..N 
."'•...•~ 37RI 
CD223? 
CRLL 
CN'v'2HX 
~t:.f 
228 
31A4 
CD7236 
CRLL 
OUT*** 
229 
31R7 
3R4531 
LDR 
CN+/ 
230 
37RR 
Cl>1236 
CALL 
OUT*** 
23/ 
37RD 
3ERi:1 
t1'v'I A .., ..' 


232 
37RF 
CD7236 
CALL 
OUT*** 
233 
3782 
CD/(~37 
CRLL 
FHSTRG 
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PRGE 
85 
««( 
Z E 0 BUG 
/'1a N I TOR 
»» 


234 3785 FERE 
CPI 
, , 


235 
37B7 
C25636 
RRTILT 
JNE 
TILT 
236 
378R 
78 
,.,oll R ..B 
237 
37BB 
B7 
ORR 
R 
238 
378C 
CRI436 
12 
RESUME 
239 
37BF 
70 
/'1oll R,L 
248 
37C8 
2188118 
RR2 
LXI 
H .•[I 
241 
RROR 
EQU 
RR2+1 
242 37C3 
77 
,.,Oll M ..R 
243 
37C4 
C31436 
J/'1P 
RE5U/'1E 
244 
* 
245 
* EXR/'1INE//'10LHH FLRGS 
246 
* 
247 
37C7 
C06F36 
FR 
CRLL 
RKB*** 
248 
37CR 
213239 
LXI 
H ..F 
249 
37CD 
FER{I 
CPI 
258 
37CF 
288D 
$ 
8EQ 
FRI 
251 
37DI 
FER 7 
CPI 
'R? 
252 
371>3 C25636 
JNE 
TILT 
253 
37D6 
212R39 
LXI 
H,F' 


254 
37D9 
3ER8 
/'1VI 
R, , , 


255 
37D8 
CD7236 
CRLL 
OUT*** 
256 
37DE 
22CI37 
FRI 
5HLD 
RRDR 
257 
37EI 
7E 
/'101/ R,/'1 
258 
37E2 
214D38 
LXI 
H,DFR/'11 
259 
37E5 
C05E38 
CRLL 
CNVTF 
268 
37E8 
213C38 
LXI 
H ..F05P 
261 
37£8 
CD6937 
CRLL 
PRT*** 
262 
37EE 
3ER(~ 
FRR 
MVI 
R 
' , 
.' 
263 
37F8 
CD7236 
CRLL 
oUT*** 
264 
37F3 
CD6F36 
CRLL 
RK8*** 
265 
37F6 
FERE 
CPI 
266 
37F8 
CRI436 
JEQ 
RE5U/'1E 
267 
37F8 
8688 
/'1VI 
B, '88 
268 
37FD 
FED3 
CPI 
'5' 


269 
37FF 
2823 
$ 
8EQ 
FR2 
278 
3881 
C838 
$ 
LRB 
271 
3883 
FEDR 
CPI 
'Z' 


272 3885 281D 
$ 
BEQ 
FR2 
273 3887 C838 
$ 
LRB 
274 3889 C838 
$ 
LRB 
275 3888 FECI 
CPI 
'·R' 


276 
388D 
2815 
$ 
BEQ 
FR2 
277 
388F 
C838 
$ 
LR8 
278 
3811 
C838 
$ 
LR8 
279 
3813 
FED6 
CPI 
'1/'. 


288 
3815 
288D 
$ 
8EQ 
FR2 
281 
3817 
C838 
$ 
LR8 
282 
3819 
FECE 
CPI 
'N' 


283 
3818 
2887 
$ 
8EQ 
FR2 
284 
381D 
C838 
$ 
LR8 
285 
381F 
FEC3 
CPI 
'C' 


286 
3821 
C25636 
FTILT 
JNE 
TILT 
287 3824 CD6F36 
FR2 
CRLL 
RK8*** 
288 3827 2RCI37 
LHLD 
RRDR 
289 
382R 
FE81 
CPI 
'I ' 


298 
382C 
288R 
$ 
8£0 
FR4 
291 
382E 
FE88 
CPI 
'8' 
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PRGE 
86 
««( 
Z E 0 
8 U G 
/'ION 
I TOR 
»» 


292 
3830 
28EF 
$ 
BNE 
FTILT 
293 
3832 
78 
/'IOV 
R,8 
294 
3833 
2F 
C/'IA 
295 
3834 
R6 
RNR 
/'I 
296 
3835 
77 
FR3 
MOV 
/'I,A 
297 
3836 
1886 
$ 
8RR 
FRR 
298 
3838 
78 
FR4 
MOV 
R,8 
299 
3839 
86 
ORR 
/'I 
380 
383A 
18F9 
$ 
BRR 
FR3 
381 
383C 
D3R8DRR8 
FDSP 
RSC 
"5 Z 
- R 
- V N C' 


302 
384B 
80SA 
ORTR 
:8D ..:SR 
383 
384D 
DFR/'II 
RES 
16..' , 


304 
385D 
OC 
DATA 
'\ ' 


305 
* 
306 
* CONVERT 
F REGISTER 
FOR 
DISPLRY 
IN 
387 
* RRER 
POINTED 
TO BY 
H&L 
308 
* 
389 
385E 
47 
CNVTF 
/'IOV 
B ..R 
310 
385F 
3E58 
/'IVI 
A ..:58 
311 
3861 
4F 
MOV 
C,R 
312 
3862 
CBla 
$ 
RBL 
313 
3864 
17 
RRL 
314 
3865 
77 
/'10V 
/'I 
..R 
5 
315 
3866 
23 
INX 
H 
316 
3867 
23 
INX 
H 
317 
3868 
79 
MOV 
R,C 
318 
3869 
C810 
$ 
R8L 
319 
3868 
17 
RRL 
320 
386C 
77 
MOV 
/'I,A 
Z 
321 
386D 
23 
INX 
H 
322 
386E 
23 
INX 
H 
323 
386F 
23 
INX 
H 
324 
38713 23 
INX 
H 
325 
3871 
C81(~ 
$ 
R8L 
326 
3873 
CBle 
$ 
RBL 
327 
3875 
79 
/'IOV 
R,C 
328 
3876 
17 
RRL 
329 
3877 
?7 
/'IOV 
/'I,R 
RC 
330 
3878 
23 
INX 
H 
331 
3879 
23 
INX 
H 
332 
387A 
23 
INX 
H 
333 
387B 
23 
INX 
H 
334 
387C 
CBla 
$ 
RBL 
335 
387'£ C818 
$ 
R8L 
336 
3888 
79 
/'fOV 
A,C 
337 
3881 
17 
RRL 
338 
3882 
77 
/'10V 
/'I,R 
P/V 


339 
3883 
23 
INX 
H 
340 
3884 
23 
INX 
H 
341 
3885 
CBla 
$ 
RBL 
342 
3887 
79 
/'10V 
R,C 
343 
3888 
17 
RAL 
344 
3889 
77 
/'IOV 
/'I,R 
N 
345 
388R 
23 
INX 
H 
346 
388B 
23 
INX 
H 
347 
388C 
C81a 
$ 
RBL 
348 
388E 
79 
/'fOV 
R,C 
349 
388F 
17 
RAL 
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PAGE 
t17 
«<:« 
ZED 
B U 
G 
1'1a N 
I T a R 
))X> 


35t'!3890 
17 
1'101/ 1'1.' 
A 
C 
351 
3891 
C9 
RET 
352 
* 
353 
* EXAI'1INE//'10DIF'r' 
REGISTER 
PAIRS 
354 
* 
355 3892 
213639 
BCP 
LXI 
H ..B 
356 3895 
1813D 
$ 
8RA 
ARPEE 
357 3897 
213839 
DEP 
LXI 
H ..D 
358 
389R 
18138 
$ 
8RA 
ARPEE 
359 
389C 
213439 
HLP 
LXI 
H,H 
3613 389F 
18133 
$ 
8RA 
ARPEE 
361 
38AI 
213£39 
5P 
LXI 
H ..STKP 
362 
38A4 
CD6F36 
ARPEE 
CALL 
RK8*** 
363 
38A7 
FEA13 
CPI 
364 
38R9 
2813E 
$ 
8EL~ 
~'P2 
365 
38R8 
FER7 
CPI 
'R7 
366 
38AD 
C25636 
RPI 
JNE 
TILT 
367 
38B8 
3EA8 
I1VI 
A ../ 
/ 


368 3882 
CD7236 
CALL 
OUT*** 
369 3885 
IIF8FF 
LXI 
D ..-8 
370 3888 
19 
DAD 
D 
37/ 
38B9 
22EB38 
RP2 
SHLD 
RPRDR 
372 
38SC 
23 
INX 
H 
373 
38BD 
7£ 
/'10 V 
A ..1'1 
374 
388E 
CD2237 
CRLL 
CNV2HX 


375 
38CI 
CD7236 
CRLL 
OUT*** 
376 
38C4 
3A4537 
LDA 
CN+I 
377 
38C7 
CD7236 
CALL 
OUT*** 
378 
38CA 
28 
DCX 
H 
379 
38CB 
7E 
110V 
R,I'1 
388 
38CC 
CD2237 
CALL 
CNV2HX 
381 
38CF 
CD 7236· 
CRLL 
OUT*** 
382 
38D2 
3A4537 
LDA 
CN+I 
383 
38D5 
CD7236 
CALL 
OUT*** 
384 
38D8 
3EA13 
/,/VI 
A 
/ , 
.' 
385 
38DA 
CD7236 
CALL 
OUT*** 
386 
38DD 
CDI837 
CALL 
FHSTRG 
387 
38EO 
FEAE 
CPI 
/ , 


388 
38E2 
2tiC9 
$ 
BNE 
RPI 
389 
38E4 
78 
/'10~' A ..B 
390 
38E5 
B7 
ORA 
A 
391 
38E6 
CAI436 
JZ 
RESU/'1E 
392 
38E9 
EB 
XCHG 
393 
38EA 
218€Jtl8 
RP3 
LXI 
H, ti 
OPERAND 
FILLED 
IN ABOVE 
394 
RPADR 
EQU 
RP3+1 
395 
38ED 
73 
/'/OV 
/'1 
..E 
396 
38EE 
23 
INX 
H 
397 
38EF 
72 
/'10 V 
/'1 
..D 
398 
38F8 
C31436 
J/'1P 
RE5U/'1E 
399 
38F3 
213A39 
XREG 
LXI 
H,X 
488 
38F6 
1883 
$ 
BRA 
'r'R2 
481 
38F8 
213C39 
'r'REG 
LXI 
H, ~' 
482 
38FB 
CD6F36 
'r'R2 
CALL 
RKB*** 
483 
38FE 
FEA8 
CPI 
484 3988 
28RB 
$ RP4 
BHE 
RPI 
4€15 3982 
1885 
, 
BRA 
RP2 
486 
* 
487 
'" 
JU/'1PPROCESSOR 
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408 
489 3904 CDDB3D 
4/8 39l~7 CR5636 
4/ / 39l1RFERE 
4/2 398C 28F2 
4/3 398E 222839 
4/4 
4/5 
4/6 
39// 
3/2R39 
4/739/4 
F/ 
4/8 39/5 88 
4/9 39/6 E/ 
420 39/7 C/ 
42/ 
39/8 
D/ 
422 39/9 D9 
423 39/R F/ 
424 39/B E/ 
425 :~9/C C/ 
426 39/D D/ 
427 39/E ODE/ 
428 3928 FDE/ 
429 3922 ED1B3£39 
43a 3926 F3 
43/ 3927 C3ea88 
432 
433 
434 
435 392R oe 
436 3928 oe 
437 392C Ol18tl 
438 392E 8l~88 
439 3938 8888 
440 3932 80 
44/ 3933 08 
442 3934 888a 
443 3936 0888 
444 3938 8a8l' 
445 393R 8888 
446 393C l~(J88 
447 :?93E 8888 
448 394(J FFFF 
449 3942 
450 3945 808l~ 
45/ 3947 8888 
452 3949 8a 
453 394R C3F839 
454 3940 CECFRaD8 
455 395E C2CBD8D4 
456 396E 
457 3972 
DC 
458 
459 
46a 
46/ 
3973 CDDB3D 
462 3976 
288F 
463 3978 FER8 
464 397R 28a7 
465 397C FERE 


*JUI'1P 
CRLL 
FPRI'1 
JI'1/ 
JZ 
TILT 
CPI 
$ 
BNE 
RP4 
SHLD 
JI'1P+/ 
C0l'11'10N 
CODE 
TO LORD REGISTER 
RND POINTERS. 


JI'12 
LXI 
SP..F' 


POP 
PS/4 
$ 
XRF 
POP 
H 
POP 
B 
POP 
D 
$ 
EXX 
POP 
PS/4 
POP 
H 
POP 
B 
POP 
D 
$ 
POP 
X 


$ 
POP 
'r' 
$ 
LSPD 
STKP 
E/I 
DI 
INITIRLIZE 
TO DISRBLE 
JI'1P 
JI'1P 
a 
** REGISTER 
STORRGE 
*F' 
*** 
R' 
*** 
H' 
DBL 
a 
B' 
DBL 
a 
D" 
DBL 
a 
F 
*** 
R 
*** 
H 
D8L 
(J 
B 
DBL 
8 
D 
DBL 
a 
x 
DBL 
£1 


'r' 
DBL 
a 
STKP 
DBL 
8 
BPR 
DBL 
-/ 
BKPT RDDRESS 
BPI 
RES 
:3 
TSTRCK 
DBL 
e 
DIFF 
DBL 
0 


ILOC 
*'1'* 


RTINST 
JI'1P RTN 
NPBI'1SG RSC 
'NO PREVIOUS 
BKPT\' 


BP~'1'1SGRSC 
'BKPT RERCHED 
RT 
' 
8PRLOC 
RES 
4 
DRTR 
'\ ' 


*'"BRERKPOINT 
'"XEQ 
CRLL 
FPRI'1 
$ XEQ8 
BZ 
JI'1/ 
CPI 
NE/4 BRERKPOINT? 
$ 
BEQ 
XEQ2 
'r'ES 
CPI 
, 
" 
USE THE OLD ONE? 
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466 397E C25636 
XEQI 
JNE 
TILT 
NO, GRRBRGE 
467 
3981 
182B 
$ 
BRR 
XEQ4 
468 
3983 
222839 
XEQ2 
sHLD 
JI'1P+1 
SET JUI'1PRDDREsS 
469 
3986 
CDD830 
CRLL 
FPR/'I 
GET BKPT RDDRESS 
478 
3989 
28EB 
$ 
BZ 
XEQ8 
471 
3988 
FERc 
CPI 
' , 
END IN PERIOD? 
472 3980 28EF 
$ 
BNE 
XEQI 
NO.. GRRBRGE 
473 398F 224839 
XEQ3 
SHLO 
BPR 
SRVE 8KPT RDDRESS 
474 
3992 
114239 
LXI 
D,BPI 
475 
3995 
818388 
LXI 
8,3 
476 
3998 
EOB8 
$ 
/'I14+R 
sRVE PROGRRI'1140RDS 
477 399R ED5B4039 
$ 
LOEO 
8PA 
478 399E 214R39 
LXI 
H,RTINST 
479 39Rl 818388 
LXI 
B,3 
480 39R4 EDB8 
$ 
I'1I4+R 
/'lOVEIN BKPT RETURN 
INsT. 


481 39R6 3E81 
/'IVI A, I 
482 39R8 324939 
sTR 
ILOC 
483 39R8 C31 139 
JI'IP J/'I2 
484 
CONTINUE 
PREVIOUS 
8KPT 
485 39RE E0484839 
$ XEQ4 
L8CD 
BPR 
486 39B2 
78 
/'IOV R,B 
URs THERE R PREVIOUS 
8KPT? 
487 
3983 
FEFF 
CPI 
:FF 
488 39B5 288E 
$ 
8NE 
XEQ5 
489 
3987 
79 
/'tOV R,C 
498 
3988 FEFF 
CPI 
:FF 
491 398R 2889 
$ 
BNE 
XEQ5 
492 398C 214039 
LXI 
H,NP81'1sG 
493 398F C06937 
CRLL 
PRT*** 
494 39C2 C31436 
JffP 
RESU/'IE 
495 39C5 ED484839 
$ XEQ5 
L8CD 
BPR 
496 39C9 E0432839 
$ 
S8CD 
J1'IP+1 
497 39CD 
18C8 
$ 
8RR 
XEQ3 
498 
* 
499 
* BRERKPOINT 
FRILURE 
RETURN 
588 
* 
581 39CF CDE739 
BPFRIL 
CRLL 
CLBKPT 
582 3902 210839 
LXI 
H,BPF1'ISG 
583 3905 CD6937 
CRLL 
PRT*** 
PRINT FRIL I'1ESSRGE 
584 3908 C31436 
JI'IP RESUI'IE 
585 3908 C2CBO£tD4 
BPFI'/SG RSC 
'BKPT FRILEO\' 
586 
* 
587 
* CLERR BRERKPOINT 
508 
* 
589 39E7 ED5B4839 
$ CLBKPT 
LOED 
BPR 
510 39E8 214239 
LXI 
H,BPI 
511 39EE 018388 
LXI 
B,3 


512 39Fl EOB8 
$ 
1'IW+R 
513 39F3 RF 
ZRR 
514 39F4 324939 
STR 
ILOC 
515 39F7 
C9 
RET 
516 
* 
517 
* BRERKPOINT 
RETURN 
518 
* 
519 39F8 F3 
RTN 
DI 
528 39F9 E0734539 
$ 
SSPO 
TSTRCK 
521 39FO 313E39 
LXI 
SP,STKP 
522 3R88 FOE5 
$ 
PUSH 
'r' 
523 3R82 00E5 
$ 
PUSH 
X 


444 


524 
3R84 
D5 
PUSH 
D 
525 
3R85 
C5 
PUSH 
B 
526 
3R86 
E5 
PUSH 
H 
527 
3R87 
F5 
PUSH 
PSU 
528 
3R88 
D9 
$ 
EXX 
529 
3R89 
88 
$ 
XRF 
538 
3R8R 
D5 
PUSH 
D 
531 
3R8B 
C5 
PUSH 
8 
532 
3R8C 
E5 
PUSH 
H 
533 
3R8D 
F5 
PUSH 
PSU 
534 
3R8E 
318836 
LXI 
sP,ZED8UG 
535 
3R II COE739 
CRLL 
CLBKPT 
CLERR 
THE BRERKPoINT 
536 
3RI4 
2R4539 
LHLD 
TsTRCK 
537 
3RI7 
E05B3E39 
$ 
WED 
STI<P 
538 
3RIB 
87 
RsC 
539 
3RIC 
ED52 
$ 
DsC 
D 
FORH 
sTRCK 
DIFFERENCE 
548 
3RIE 
224739 
sHLD 
DIFF 
541 
3R21 
2R4539 
LHLD 
TsTRCK 
542 
3R24 
223E39 
sHLD 
STKP 
543 
3R27 
2R4839 
LHLD 
BPR 
544 
3R2R 
I16E39 
LXI 
D,8PRLOC 
545 
3R20 
CDB73B 
CRLL 
DCoN 
546 
3R38 
215E39 
LXI 
H,8PR/'ISG 
547 
3R33 
C06937 
CRLL 
PRT*** 
548 
3R36 
C38R3R 
JI1P 
R2$ 
- 


549 
* 
558 
* SET 
ENRBLE/OIsRBLE 
FLRG 
551 
* 
552 
3R39 
CD6F36 
IE 
CRLL 
RK8*** 
553 
3R3C 
86F3 
/'IVI 
8, 'F3 
554 
3R3E 
FEC4 
CPI 
'0' 


555 3R48 
2884 
$ 
BEQ 
lET 
556 
3R42 
86F8 
/'IVI 
B, 'FB 
557 
3R44 
FEC5 
CPI 
'E' 
558 
3R46 
C25636 
lET 
JNE 
TILT 
559 
3R49 
C06F36 
CRLL 
RKB*** 
560 
3R4C 
FERE 
CPI 
' , 
561 
3R4E 
28F6 
$ 
BNE 
lET 
562 
3R50 
78 
IE2 
/'fOV 
R,B 
563 
3R51 
322639 
sTR 
E/I 
564 
3R54 
C31436 
JI1P 
RESUI1E 
565 
* 
566 
* 
567 
* /'IoOIFY/OISPLRY PSEUDO 
REGISTERS 
568 
* 
569 
3R57 
C06F36 
R 
CRLL 
RKB*** 
578 
3R5R 
FERE 
CPI 
' , 
571 
3R5C 
CR8R3R 
JEQ 
R2$ 
572 
3R5F 
FECI 
CPI 
'R' 


573 
3R61 
CR8737 
JEQ 
RR 
574 
3R64 
FEC6 
CPI 
'F' 
575 
3R66 
CRC737 
JEQ 
FR 
576 
3R69 
FEC2 
CPI 
'B' 


577 
3R6B 
CR9238 
JEQ 
8CP 
578 
3R6E 
FEC4 
CPI 
'0' 
579 
3R78 
CR9738 
JEQ 
OEP 
588 
3R73 
FEC8 
CPI 
'H' 


581 
3R75 
CR9C38 
JEQ 
HLP 
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582 
3R78 
FED3 
CPI 
'5/ 
583 
3R7R 
CRRI38 
JEll 
SP 
584 
3R7D 
FED8 
CPI 
'X' 


585 
3R7F 
CAF338 
JEl~ 
XREG 
586 
3R82 
FED9 
CPI 
""". 
587 
3A84 
CRF838 
JEll 
~'REG 
588 
3R87 
C35636 
J/'IP 
TILT 
589 
3R8R 
3A3339 
R2S 
LDR 
A 
590 
3R8D 
CD2237 
CALL 
CNV2HX 
CONVERT 
A 
591 
3A98 
327738 
5TR 
ARF 
592 
3R93 
3R4537 
LDR 
CN+I 
593 
3R96 
327838 
5TA 
ARF+I 
594 
3R99 
2R3639 
LHLD 
B 
595 
3R9C 
I16738 
LXI 
L> .• R8CF 
596 
3R9F 
CDB73B 
CRLL 
DCON 
597 
3RR2 
2A3839 
LHLD 
D 
598 
3RR5 
I16C38 
LXI 
D,RDEF 
599 
3AR8 
CD8?38 
CRLL 
DCoN 
688 
3RR8 
2R3439 
LHLD 
H 
681 
3ARE 
II?/38 
LXI 
D,RHLF 
682 
3R81 
CD8738 
CRLL 
DCoN 
683 
3R84 
3R3239 
LDR 
F 
684 
3R87 
217D38 
LXI 
H,RFF 
685 
3R8R 
CD5E38 
CALL 
CNVTF 
606 
3R8D 
3ER8 
/'IVI 
R ..' , 


687 
3R8F 
326638 
5TR 
RFRRI1E 
688 
3RC2 
213F3B 
LXI 
H ..RLBLS 
689 
3RC5 
CD6937 
CRLL 
PRT*** 
618 
3RCS 
21663B 
LXI 
H,RFRR!'/E 
61 I 3RC8 
CD6937 
CRLL 
PRT"''''* 
612 
3RCE 
3ER7 
I1VI 
R, 'A7 
613 
3R08 
326638 
5TR 
/i.'FRRI1E 
614 
CONVERT 
ALTERNRTE 
REG'5 
615 
3AD3 
3R2839 
LDR 
A' 


616 
3AD6 
CD2237 
CRLL 
CNV2HX 
617 
3RD9 
327738 
5TR 
ARF 
618 
3ADC 
3A4537 
LDA 
CN+I 
619 
3ADF 
327838 
5TA 
RAF+I 
628 
3RE2 
2A2E39 
LHLD 
B' 


621 
3AE5 
I16738 
LXI 
D,A8CF 
622 
3RE8 
CD873B 
CRLL 
DCON 
623 
3REB 
2A3839 
LHLD 
D' 


624 
3AEE 
I16C3B 
LXI 
O,ADEF 
625 
3AF I COB?38 
CALL 
OWN 
626 
3AF4 
2A2C39 
LHLO 
H' 


6273AF7117138 
LXI 
O,AHLF 
628 
3AFA 
CD8?38 
CALL 
DCON 
629 
3RFD 
3R2A39 
LOA 
F' 


638 
3880 
217D3B 
LXI 
H,AFF 
631 
3883 
CD5E38 
CRLL 
CNVTF 
632 
3886 
21663B 
LXI 
H,RFRR!'/E 
633 
3809 
CD6937 
CALL 
PRT*"'* 
634 
CONVERT 
X, 
'r', 
SP ..DIFF 
635 
38eC 
2A3R39 
LHLO 
X 
636 
388F 
IIR338 
LXI 
D ..AXF 
631 3812 
CD8?38 
CALL 
DCoN 
638 
3815 
2R3C39 
LHLD 
'r' 
639 
3818 
IIR838 
LXI 
D,R~'F 
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640 
3818 
CD8738 
64/ 
381E 
2A3E39 
642 
3821 
IIRD38 
643 
3824 
l~D8738 
644 3827 2A4739 
645 
382R 
I/8238 
646 
382D 
CD8738 
647 
383fJ 2/8D38 
648 3833 CD6937 
649 
3836 
21R238 
658 
3839 
CD6937 
65/ 
383C 
C31436 
652 
653 
654 
655 
383F 
RfJAfJC2C3 
656 
3845 
A8C4C5R8 
657 
384R 
R8C8CCRfJ 
658 
3858 
CIA8R8A8 
659 
3856 
D3AfJDRRfJ 
66fJ 3866 
RfJ 
66/ 
3867 
662 
386C 
6'63 3871 
664 38?? 
665 
387D 
666 
388C 
DC 
667 
388D 
RfJRfJl>8R8 
668 
3893 
R8D9RfJR8 
669 
3898 
RfJD3DfJAfJ 
67fJ 389D 
C4C9C6C6 
67/ 
3BR2 
R8 
672 
38R3 
673 
3BR8 
674 
38RD 
675 
3882 
676 
3886 DC 
677 
678 
679 
680 
681 
388? 
7C 
682 
3888 
CD2237 
683 3888 12 
684 
388C 
/3 
685 
388D 
3R4537 
686 
38C8 
12 
68? 
38CI 
13 
688 
38G2 
7D 
689 
38C3 
CD2237 
698 
38C6 
12 
691 
38C7 
13 
692 
38C8 
3R453? 
693 
38GB 
12 
694 
38CC 
C9 
695 
696 
69? 


CALL 
DCON 
LHLD 
STKP 
LX I 
D ..RSPF 
CALL 
DCON 
LHLD 
DIFF 
LXI 
D, ADFRf1 
CALL 
DCON 
LXI 
H,XLBLS 
CALL 
PRT"''''''' 
LX I 
H, XFRAME 
CALL 
PRT"''''''' 
JMP 
RESUME 
'" 
'" 
PRINT 
RREA 


'"RL8LS 
RSC 
BC 
RSC 
, DE 
RSC 
HL 
ASC 
'R 
RSC 
"'5 Z - 
R - .'N C\' 
RFRRME 
DATA 
RBCF 
RES 
5, " , 


ADEF 
RES 
5.., , 


RHLF 
RES 
6,, , 


RRF 
RES 
6.., , 


RFF 
RES 
15.., , 


DATA 
'\' 


XL8LS 
RSC 
, 
X 


ASC 
, 'r' 
RSC 
, SP 
ASC 
'DIFF\' 


XFRRME 
DRTA 
AXF 
RES 
5, , , 


RW-- 
RES 
5, , , 


RSPF 
RES 
5, , , 


RDFRM 
RES 
4 .. , 


DATR 
'\ ' 


'"'" CONVERT 
THE NUM8ER 
IN HAND 
L 
TO 4 CHAR'S 
'"BEGINNING 
RT 
THE ADDRESS 
IN D AND 
E. 


'"OCON 
MO.' 
CALL 
STRX 
INX 
LDA 
STAX 
INX 
MOV 
CALL 
STAX 
INX 
LDA 
STAX 
RET 


A,H 
CNV2HX 
o 
D 
CN+I 
Do 
A..L 
CNV2HX 
o 
D 
CN+I 
o 


'"'" CONVERT 
ANO 
PRINT 
THE 
140RO IN R 
'" 


698 
38CD 
C0223'1 
699 
38Dtl CD7236 
'1aa 3803 
3R4537 
7a I 38D6 
CD7236 
782 
3809 
C9 
7B3 
'1a4 
785 
786 
38VA 
CD0830 
7B? 
3BDO 
281C 
7~8380F 
FERE 
7B9 
38EI 
2018 
71tJ 38E3 
7D 
711 
38E4 
32E838 
712 
38E7 
C07637 
713 
38ER 
0880 
714 
38EC 
CDCD3B 
715 
38EF 
CD6F36 
716 
38F2 
FER8 
717 
38F4 
28FI 
718 
38F6 
FERE 
719 
38F8 
CRI436 
728 
3BF8 
C35636 
721 
722 
723 
724 
3BFE 
C00830 
725 
3Ca I 28F8 
726 
3C93 
FER(-l 
727 
3C05 
20F4 
728 3Cl~7 7D 
729 
3C88 
321B3C 
730 
3C8B 
CODB3D 
731 
3Cl~E 28E6 
732 
3CI0 
FERE 
733 
3CI2 
28B4 
734 3C14 FERfJ 
735 
3CI6 
20E3 
736 
3CI8 
F5 
737 
3CI9 
7D 
738 
3CIR 
D38a 
739 
3CIC 
FI 
748 
3CID 
FERE 
741 
3CIF 
28D7 
742 
3C21 
18E8 
743 
744 
745 
746 
747 
748 
3C23 
CD6F36 
749 
3C26 
FERE 
758 
3C28 
C25636 
751 
3C28 
B600 
752 
3C20 
C06336 
753 
3C38 
C06936 
754 
3C33 
CD653E 
755 
3C36 
FEFF 


CRLL 
CRLL 
LOR 
CRLL 
RET 


CNV2HX 
OUT**'I' 
CN+I 
OUT*** 


** INPUT 
FROM 
DEVICE 
N 
*INPUT 


********************************************* 
* OBJECT 
LaRDER 
FOR 
28B 
RESIDENT 
RSSE/'/BLER * 
******************************************** 
*LaRDER 
CRLL 
RK8*** 
CPI 
JNE 
MVI 
CRLL 
CRLL 
CRLL 
CPI 


CRLL 
B2 
CPI 
8NE 
MOV 
STR 
CRLL 
IN 
CRLL 
CRLL 
CPI 
BEl) 
CPI 
JEI) 
JMP 


INTLT2 
R..L 
INPT2+1 
CRLF** 
B 
Pl<I 
RK8*** 


RESUME 
TILT 


INPT3 
INRSM 
INTL T2 
** OUTPUT 
TO DEVICE 
N 
*OUTPUT 
CRLL 
FPRM 
8Z 
INTLT2 
CPI 
8NE 
MOV 
STR 
OUTPTI 
CRLL 
82 
CPI 
8EI) 
OTPTIR 
CPI 
BNE 
OTPTIR 
PUSH 
/'/01,' 


OUTPT2 
OUT 
POP 
CPI 
8EQ 
INRSM 
BRR 
OUTPTI 


INTL T2 
R,L 
OUTPT2+1 
FPRM 
INPT3 


INTL T2 
PSl<I 
R,L 
9 
PSl<I 


TILT 
8,8 
INRDR 
RORSTT 
RDFRM 
:FF 


INITIRLIZE 
6828 
STRRT 
REROER 
GET 
TRPE 
FRRME 
RECORD 
/'IRRK 


756 
3C38 
2885 
757 
3C3A 
t15 
758 
3C38 
28F6 
759 
3C30 
185R 
760 
3C3F 
57 
761 
3C40 
C0653E 
762 
3C43 
6F 
763 
3C44 
C0653E 
764 
3C47 
67 
765 
3C48 
C0653E 
766 
3C48 
87 
767 
3C4C 
2017 
768 
3C4E 
C0653E 
769 
3C51 
47 
771.-1: 
3C52 
CD653E 
771 
3C55 
77 
772 
3C56 
23 
773 
3C57 
IOF9 
774 
3C59 
5R 
775 
3C5R 
C0653E 
776 
3C50 
AB 
777 
3C5E 
2ttlE 
778 
3C6Q 
068R 
779 
3C62 
C3333C 
780 
781 
782 
783 
3C65 
C0653E 
784 
3C68 
32B83C 
785 
3C68 
C0653E 
786 
3C6E 
32B93C 
787 
3C71 
CD653E 
788 
3C?4 
4F 
789 
3C75 
CD653E 
798 
3C?8 
47 
791 
3C79 
5R 
792 
3C7A 
CD653E 
793 
3C7D 
RB 
794 
3C?E 
281F 
795 
3C8tl 3RB83C 
796 
3C83 
87 
797 
3C84 
28DR 
798 
3C86 
3R893C 
799 
3C89 
57 
80l~ 3C8A 
CD6C36 
801 
3C8D 
72 
882 
3C8E 
23 
8f13 3C8F 
tt8 
884 
3C98 
78 
8135 3C91 
BI 
886 
3C92 
28F9 
8a7 
3C94 
CD6936 
888 
3C97 
18C? 
8tt9 
81 (-I 3C99 
CD6C36 
811 
3C9C 
C31436 
8/2 
813 


8EQ 
DCR 
8NZ 
BRA 
MOV 
CRLL 
MOV 
CRLL 
MOV 
CRLL 
ORR 
8NZ 
CRLL 
MOV 
CALL 
/'10 V 
INX 
DBNZ 
MOV 
CRLL 
XRR 
8NZ 
MVI 
JMP 


LOAD2 
B 
LOAD 1 
LORDI,JT 
D,R 
RDFRM 
LR 
RDFRM 
H .•R 
RDFRM 
R 
H'PEI 
RDFRM 
8..A 
RDFRM 
/'I,R 
H 
LOAD3 
E,D 
RDFRM 
E 
H'PEla 
8,18 
LOAD 1 


STRRT 
CHECKSUM 


GET 
RECORD 
ORIGIN 


ORIGIN 
IN H&L 
GET 
RECORD 
TYPE 


GET 
RECORD 
LENGTH 
SRVE 
IN 8 


RERO 
AND 
STORE 
RECORD 


SRVE 
THE 
CHECKSUM 
GET 
CHECKSUM 
VERIFY 


SET 
INTERRECORD 
GRP 
LENGTH 


** LORD 
"RES" 
TYPE 
RECORD 
*H'PEI 
CRLL 
STR 
CRLL 
STR 
CRLL 
MOV 
CRLL 
MOV 
MOV 
CRLL 
XRR 
BNZ 
LOR 
ORR 
8Z 
LOR 
/'fOV 
CRLL 
MO~' 
INX 
DCX 
MOV 
ORR 
BNZ 
CRLL 
BRR 


RDFR/'I 
FLFLRG 
RDFR/'t 
FLCHR 
RDFRM 
C.•R 
RDFRM 
8 ..R 
E,D 
RDFRM 
E 
CKSMER 
FLFLRG 
R 
LORD4 
FLCHR 
D,R 
RDRSTP 
M..D 
H 
B 
A,B 
C 
TYPEIR 
RDRSTT 
LORD4 


FILL 
FLRG 


FILL 
CHRRRCTER 


GET 
"RES" 
LENGTH 


SRVE 
THE 
CHECKSUM 
GET 
CHECKSUM 
VERIn' ... 
CHECKSUM 
ERROR 
"'RS THERE 
R FILL 
CHRRRCTER? 


YES ..GET 
IT 


JUST 
IN CRSE ... 


*LORD"'T 
CRLL 
RDRSTP 
JMP 
RESU/'tE 
** CHECKSUM 
ERROR 
PROCEDURE 


814 
815 
3C9F 
CD6C36 
816 
3CA2 
3EC3 
817 
3CR4 
CD1236 
818 
3CA7 
3ECB 
819 
3CR9 
CD1236 
8213 3CAC 
3E03 
82/ 
3CRE 
CD1236 
822 
3CBI 
3ECD 
823 
3CB3 
CD7236 
824 
3C86 
18E/ 
825 
826 
3e88 
08 
827 3(:89 Lit! 
828 
829 
830 
83/ 
832 
833 
834 
835 
836 
831 
838 
B39 
84Li 
841 
842 
843 
844 
845 
846 
841 
848 
849 
85(~ 
85/ 
852 
853 
854 
855 
856 
851 
858 
859 
860 
861 
862 
863 
864 
865 
866 
861 
868 
869 
87t! 
8?t 


3CBR 
CDDB3D 
3C8D 
CA5636 
3CCO 
FEAO 
3CC2 
C25636 
3CC5 
22593D 
3CC8 
CDD83D 
3CCB 
28FO 
3CCD 
FERE 
3CCF 
C25636 
3C02 
ED5B593D 
$ 
3CD6 
31 
3C07 
EB 
3CD8 
ED52 
3COR 
7C 
3CD8 
81 
3CDC 
F25636 
3COF 
CD1E36 
3CE2 
063C 
3CE4 
RF 
3CE5 57 
3CE6 
CDSDD 
3CE9 
ILiFB 
$ 
3CEB 
DD2R593D 
$ 
3CEF 
24 
3CFt1 2829 
3CF2 
C0423D 
3CF5 
AF 
3CF6 
CD5E3D 
:'CF9 DD1EO€i 
3CFC 
CD5E30 
3CFF 
DD23 
3DEI/ C07836 
3D04 
ORI436 
3DEI? IEIFO 
3D09 
7A 
3DElA CD5E3L> 
30tlD RF 
30ElE CD5E30 
301/ 
RF 
3DI2 
CD5E3D 
3015 
DD22593D 
$ 


*FLFLRG 
FLCHR 
** OUNP 
*DUNP 
DU/'IPO 


CRLL 
RDRSTP 
/'IV I 
A .. 'C 
CRLL 
OUT*** 
MVI 
R.. 'K' 


CALL 
OUT*** 
MVI 
A ..'s' 


CALL 
OUT*** 
MVI 
A ..'1'1' 


CALL 
OUT*** 
BRA 
LOADla 


CRLL 
JZ 
CPI 
JNE 
5HLD 
CRLL 
BZ 
CPI 
JNE 
LDEO 
5TC 
XCHG 
D5C 
MOV 
ORA 
JP 
CRLL 
MVI 
ZAR 
NOV 
CALL 
D8NZ 
LXC> 
INR 
BZ 
CRLL 
ZAR 
CRLL 
LRX 
CRLL 
INX 
CALL 
JC 
DBNZ 
/'10 V 
CALL 
ZAR 
CALL 
ZRR 
CALL 
5XD 


FPFm 
TILT 


TILT 
DTE/'1P 
FPR/'1 
DUNPO 


D 
R,H 
R 
TILT 
58 
B,60 


D,A 
PUNCH 
DU/'1PI 
DTE/'1P 
H 
LRCORD 
PROLOG 


PUNCH 
o 
PUNCH 
X 
DTCTCC 
RE5UNE 
DUNP3 
R ..D 
PUNCH 


PUNCH 


PUNCH 
DTENP 


GET 
FIRST 
ADDRE55 
NOTH ING 
n'PED 
NU5T 
8E 
8LANK 


SRI,'ESTART 
ADDRE55 
GET 
SECOND 
ADDRESS 


/'1UST8E 
PER lOD 


FORN 
INCLU5II,~ 
NEGATIVE 
DIFF 
GET 
HIGH 
ORDER 


1ST RDORESS 
) 2ND 
ADDRES5 
WRIT 
FOR 
5PRCE 
GET 
LERDER 
LENGTH 


PUNCH 
LERDER 


5TRRT 
RDDRE5S 
IN X 
LRST 
PRGE? 


PUNCH 
R./'1.& ORIGIN 


PUNCH 
RECORD 
LENGTH 
GET 
FRANE 
FRON 
NENORY 


PUNCH 
RECORD 
GET 
CHECK5UN 
PUNCH 
IT 


PUNCH 
INTERRECORD 
GAP 


872 
3019 
/8D4 
$ 
BRA 
DUMP2 
8'13 
3D/B 
CL>423D 
LRCORD 
CALL 
PROLOG 
PUNCH 
LAST 
RECORD 
PROLOGUE 
874 JD/E 
7D 
MOV 
A ..L 
GET 
LRST 
RECORO 
LENGTH 
875 
~'DIF £044 
$ 
NEG 
876 JD2/ 
47 
MOV 
B.. A 
877 
3D22 C05EJD 
CALL 
PUNCH 
PUNCH 
RECORD 
LENGTH 
878 
JD25 
OD7El3l~ 
$ DUMP4 
LRX 
0 
GET 
FRA/'IE 
819 3D28 
CD5E3D 
CALL 
PUNCH 
880 3D2B 
DD23 
$ 
INX 
X 


88/ 
J[J2D IOF6 
$ 
DBNZ 
DU/'IP4 
882 
JD2F 
7A 
/'10 
'v' 
A ..D 
883 
3D30 
CD5E3D 
CALL 
PUNCH 
PUNCH 
CHECKSUI1 
884 JD33 
AF 
ZAR 
885 
3D34 
57 
NO~' 
D.,A 
886 3D35 
0646 
NVI 
B.,70 
TRRILER 
LENGTH 
887 
.'3D37 
CD5E3D 
DUNP5 
CALL 
PUNCH 
888 J[13A10FB 
$ 
DBNZ 
DUI1P5 
889 3D3C 
CD7E36 
CALL 
SB 
blAlT FOR 
SPRCE 
890 JD3F 
C3/436 
J/'IP 
RESU/'IE 
RETURN 
TO /'IONlTOJ<' 


89/ 
* 
892 
* PUNCH 
R. N .., ORIGIN 
RNi> TYPE 
893 
* 
894 3D42 
JEFF 
PROLOG 
NVI 
A ..'FF 
RUBOUT 
FOR 
RECORD 
I1ARK 
895 
3D44 
CD5E30 
CRLL 
PUNCH 
896 3D47 
57 
NO\-' 
D ..A 
INITIALIZE 
CHECKSUM 
897 
3D48 
JA593D 
LDA 
DTENP 
LObi ORIGIN 
ADDRESS 
898 
3D4B 
CD5E3D 
CALL 
PUNCH 
899 
3D4E 
3A5AJD 
LDA 
DTH1P+1 
9l~03D51 
CD5E3D 
CALL 
PUNCH 
91113D54 
AF 
ZAR 
902 3D55 
CD5E3D 
CALL 
PUNCH 
PUNCH 
RECORD 
n'PE 
903 3D58 
C9 
PET 
9134 3D59 
DTENP 
RES 
.5.,0 
905 
.... 
906 
* PUNCH 
AND 
KEEP 
CHECKSUM 
907 
* 
988 305E 
Fe' 
PUNCH 
PUSH 
PSH 
~, 
909 3D5F 
82 
ADD 
D 


910 3D60 
57 
110\-' D,A 
911 3D61 
FI 
POP 
PSbI 
912 3D62 
CD7836 
CALL 
PCHCHR 
913 3D65 
C9 
RET 
914 
* 
915 
* PRINT 
I1ENOR~' BLOCK 
916 
* 
917 3D66 
22593D 
PBLK 
SHLD 
DTENP 
918 3D69 
CDDB3D 
CALL 
FPf<'N 
919 3D6C 
CA5636 
JZ 
TILT 
92l~3D6F 
FEAE 
CPI 
NUST 
END 
IN PERIOD 
921 3D7/ 
C25636 
JNE 
TILT 
922 
3D74 
ED5B593D 
$ 
LOED 
DTEI1P 
923 
3D 78 B~ 
RSC 
.. 
924 3D79 
ED52 
$ 
DSC 
D 
925 
3D7B 
23 
INX 
H 
926 3D7C 
7C 
/'10V 
A,H 
927 3D7D 
B~ 
ORR 
R 
.. 
928 
3D7E 
FR5636 
JM 
TILT 
929 3D8/ 
B5 
ORR 
L 
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930 
3D82 
CR5636 
931 
3D85 
DD2A593D 
$ 
932 
3D89 
CD7637 
933 
3D8C 
3R5A3D 
934 
3D8F 
CD2237 
935 
3092 
CD7236 
936 
3D95 
3A4537 
937 
3D98 
CD7236 
938 
3D9B 
3R593D 
939 
3D9E 
W2237 
948 
3DRI 
CD7236 
941 
3DR4 
3R4537 
942 
3DR7 
CD7236 
943 
3DRR 
3ERO 
944 
3DRC 
CD7236 
945 
3DRF 
06ltl 
946 
3DBI 
3ERO 
947 
3DB3 
CD7236 
948 
3D86 
DD7E80 
$ 
949 
3DB9 
DD23 
$ 
950 
3DBB 
CD2237 
951 
3DBE 
CD1236 
952 
3DCI 
3R4537 
953 
3DC4 
CD7236 
954 
3DC7 
28 
955 
3DC8 
7C 
956 
3DC9 
B5 
951 
3DCR 
CR 1436 
958 
3DCD 
IOE2 
$ 
959 
3DCF 
DD22593D 
$ 
968 
3DD3 
CD1B36 
961 
3DD6 
DR 1436 
962 
3DD9 
18RE 
$ 
963 
964 
965 
966 
3DDB 
CDI(J37 
961 
3DDE 
32E73D 
968 
3DEI 
RF 
969 
3DE2 
80 
970 
3DE3 
3RE73D 
971 
3DE6 
C9 
972 
3DE7 ae 
913 
974 
975 
976 
3DE8 
CD273E 
971 
3DEB 
54 
978 
31>EC 5D 
919 
3DED 
13 
98e 
3DEE 
3R51>3D 
981 
3DFI 
?? 
982 
3DF2 
ED8(~ 
$ 
983 
3DF4 
C31436 
984 
985 
986 
987 
3DF7 
CD273E 


JZ 
LXD 
CRLL 
LDR 
CRLL 
CRLL 
LDR 
CRLL 
lOR 
CRLL 
CALL 
LDR 
CRLL 
NIII 
CRLL 
NIII 
NVI 
CRLL 
LRX 
INX 
CRLL 
CRLL 
LDR 
CRLL 
DCX 
NO\l 
arm 
JZ 
DBNZ 
SXD 
CRLL 
JC 
BRR 


TILT 
DTENP 
CRLF"'''' 
DTENP+I 
CNV2HX 
OUT"'*'" 
CN+/ 
OUT"''''''' 
DTENP 
CNV2HX 
OUT*"'* 
CN+I 
OUT"''''''' 
R.. / 
", 


OUT"''''''' 
B,16 
11.. '" 
'" 


OUT"''''''' 
o 
X 
CNV2HX 
OUT"''''''' 
CN+I 
OUT"''''''' 
H 
R,H 
L 
RESUNE 
PB2 
DTENP 
DTCTCC 
RE5UNE 
PBI 


'"'" FETCH 
PRRRNETER 
FRaN 
KE~BORRD 


'"FPRN 


FTENP 
* 
.'/< FILL 


'"FILL 


CALL 
STR 
ZRR 
RDD 
LDA 
RET 
"''''''' 


FH5TRG 
FTENP 


'""'"SERRCH 
NENOR~' BLOCK 
FOR 
VALUE 


'"SERRCH 
CRLL 
GETPRN 


CRLL 
NOV 
/'10 V 
INX 
lOR 
NOV 
/'I14+R 
J/'IP 


GETPRN 
D ..H 
E ..L 
D 
DIENP+4 
/'I,R 


988 
3DFA 
133 
989 
3DF8 
3A5D3D 
99a 3DFE 
BE 
991 
3DFF 
2$fJF 
992 
3E81 
CD7B36 
993 
3EfJ4 DA /436 
994 
3E8723 
995 
3E08 
08 
996 
3E89 
7$ 
997 
3EfJA 81 
998 
3E88 
2fJEE 
999 
3EtlD C31436 
(Jaa 3EI0 
C5 
0al 
3EII 
E5 
131323EI2 
11223E 
083 
3EI5 
CDB738 
8(~4 3EI$ 
21223E 
l.'!fJ5 3E 18 
CD6937 
8136 3EIE 
EI 
tlfJ7 3EIF 
CI 
808 
3E2f:1 I$DF 
0fJ9 
3E22 
8fJ8fJ8fJBfJ 
010 
0/1 
1312 
1.'1133E27 
CODB30 
014 
3E2A 
CA5636 
015 
3E20 
FEAO 
1316 3E2F 
C25636 
817 3£32 22593D 
al8 
3E35 
CDD83D 
1.1/93E38 
2$Ftl 
028 
3E3A 
FERO 
021 
3£3C 
20FI 
022 
3E3E 
22583D 
023 
3E41 
CDDB30 
924 
3E44 
28E4 
025 
3E46 
FEAE 
926 
3E48 
21.'IE5 
1.'!27 
3E4A 
7L> 
928 
3E48 
325D3D 
029 
3E4E 
EL>58593D 
838 
3E52 
2A5830 
031 
3E55 
87 
1.'1323E56 
ED52 
Kq 3E58 
L>A5636 
(~34 3E58 
7C 
035 
3E5C 
85 
1336 3E5D 
28CB 
1337 3E5F 
44 
838 
3E6a 
4D 
839 
3E61 
2A593D 
840 
3E64 
C9 
041 
842 
043 
844 
3E65 
CD6636 
845 
3E68 
F5 


INX 
B 
FORM 
INCLUSIVE 
DIFFERENCE 
Sf:1 
Lc>A 
DTENP+4 
CMP 
M 
$ 
BEa 
SRF 
SR2 
CALL 
DTCTCC 
SR3 
JC 
RESUNE 
INX 
H 
DCX 
8 
MOV 
A ..B 
ORA 
C 
$ 
8NZ 
SRI 
JNP 
"'ESUNE 
SRF 
PUSH 
8 
PUSH 
H 
LXI 
L>..FADRS 
CALL 
DCON 
LXI 
H ..FRDRS 
CALL 
PRT.'/<.'/<.'/< 
POP 
H 
POP 
8 
$ 
BRR 
SR2 
FAL>RS 
ASC 
..,tltlfJtl\/ 


.'/< 


.'/< GET 
PARANETERS 
FOR 
FILL 
AND 
SEARCH 
*GETPRM 
CALL 
FPRM 
GT2 
JZ 
TILT 
CPI 
GT3 
JNE 
TILT 
SHLc> 
DTENP 
CALL 
FPRN 
$ 
BZ 
GT2 
CPI 
$ 
BNE 
GT3 
SHLc> 
DTEMP+2 
CALL 
FPRN 
$ 
8Z 
61'2 
CPI 
$ 
BNE 
GT3 
NOll 
A ..L 
STR 
DIEMP+4 
$ 
Lc>ED 
DTENP 
LHLc> 
DTEMP+2 
RSC 
$ 
DSC 
D 
JC 
TILT 
NOll 
A ..H 
ORA 
L 
$ 
BZ 
GT2 
1'/0 V 
B ..H 
NOVE 
COUNT 
TO 8-C 
I'/Oll C ..L 
LHLc> 
DTEI'/P 
RET 


.'/<* GET 
TRPE 
FRRNE.. KEEP 
CHECKSUM 
IN D 
*RDFRM 
CALL 
GTFRM 
PUSH 
PS~J 


1346 3E69 
82 
@47 3E6R 
57 
t~48 3E6B FI 
049 3E6C C9 
858 3E6L> 


ROO 
0 
f10V 
0 ..R 
POP 
PSN 
RET 
ENO 


*************************** 
*5~'M80L 
TRBLE* 
*************************** 


R 
3933 
ROEF 
386C 
RR 
3787 
ftRTILT 37B7 
8 
3936 
BPFRIL 
39CF 
8PRMSG 
395E 
CNV2HX 
3722 
CSTK2 
368F 
OCON 
3887 
OTCTGC 
3678 
OUMPHR 
3CCF 
OUMP4 
3025 
F" 
392R 
FHGH 
3746 
FLFLftG 3C88 
FR2 
3824 
FTEMP 
30E7 
GT3 
3E2F 
HLP 
389C 
ILOG 
3949 
INPUT 
3BDR 
INSI 
36CI 
INTL 1'238F8 
JMP 
3927 
LOR02 
3C3F 
LORDur 
3C99 
OTPTIR 
3CI8 
OUTPUT 
38FE 
PCHCHR 
3678 
PRT2** 
376C 
R2$ 
3R8R 
RDRSTT 
3669 
RLBLS 
383F 
RP4 
398@ 
SRVE 
3767 
SRI 
3DF8 
STC 
3761 
TILT 
3656 
n'PEIR 3G8D 
XEQI 
397E 
XEQ5 
39C5 
\' 
393C 
ZH2 
3741 


R' 
3928 
RDF"'M 
3BB2 
ARI 
3790 
RSPF 
38RO 
8' 
392E 
8PFf1SG 39DB 
CKSME~' 3C9F 
CNVTF 
385E 
CSTK3 
36RE 
DEP 
3897 
oTEMP 
3D59 
DUf1PI 
3GE6 
DUMP5 
3D37 
FAORS 
3E22 
FH5TRG 
371@ 
FPRM 
300B 
FR3 
3835 
FTILT 
3821 
G7FRf1 
3666 
IE 
3R39 
INPTI 
38E7 
INRDR 
3663 
INS2 
3707 
INTf1NL 366tl 
JUMP 
39134 
LOAD3 
3C52 
LRCORD 
3DIB 
OUT*** 
3672 
P81 
3089 
PDVCIN 
3675 
PUNCH 
3D5E 
RRDR 
37CI 
RESUME 
3614 
RPI 
38RD 
RPRDR 
38E8 
58 
367E 
SR2 
3£81 
5TKP 
393E 
TSTRCK 
3945 
X 
393R 
XEQ2 
3983 
XFRR/'IE38R2 
\'R2 
38FB 
ZHEX 
3739 


RRF 
3B77 
RFF 
3870 
RR2 
37CH 
RXF 
38R3 
BCP 
3892 
8PI 
3942 
CL8KPT 
39E7 
CRLF"'* 3776 
o 
3938 
DFR~II 
3840 
OUMP 
3CBR 
DUMP2 
3CEF 
E/I 
3926 
FDSP 
383C 
FILL 
3DE8 
FR 
37C7 
FR4 
3838 
GETPRf1 3E2? 
H 
3934 
IE2 
3R50 
INPT2 
38ER 
INR5f1 
3BFB 
INS3 
36E8 
J/'II 
3907 
LRSTIN 
'3766 
LoR04 
3C6t~ 
MR~'BE 
36FD 
oUTPTI 
3C08 
P82 
3081 
PROLOG 
3042 
PN 
38CO 
RDFR/'I 3E65 
RFRRME 
3866 
RP2 
3889 
RTINST 
394A 
SERRCH 
30F7 
SR3 
3£84 
STRIP 
375E 
n'PEI 
3C65 
XEQ 
3973 
XEQ3 
398F 
XL8LS 
388D 
'r'REG 
38F8 


ABCF 
RHLF 
RRPEE 
RYF 
8PA 
8PRLOC 
CN 
CSTRCK 
D' 
DIFF 
OUMP13 
DUMP3 
F 
FHI 
FLCHR 
FRI 
FRR 
GT2 
H' 
lET 
INPT3 
INS 
INS3R 
Jf12 
LORDI 
LOROER 
NP8MSG 
OUTPT2 
P8LK 
PRT*** 
R 
RDRSTP 
RK8*** 
RP3 
RTN 
5P 
SRF 
TH1P** 
n'PEW 
XEQ8 
XEQ4 
XREG 
ZEOBUG 


3867 
387'1 
38R4 
3BR8 
39413 
396E 
3744 
3681 
393@ 
3947 
3CBD 
3CF9 
3932 
3715 
3C89 
370E 
37EE 
3E2A 
J92C 
3R46 
3BF6 
3682 
36F8 
39/1 
3C33 


3940 
3CIR 
3D66 
3?69 
3R57 
366C 
366F 
38ER 
39F8 
38RI 
3Elt~ 
3786 
3C7E 
3976 
39RE 
38F3 
360t~ 


APPENDIX D / 
CROSS INDEX OF 
ASSEMBLERMNEMONICS 
WITH 
ZllOG 
MNEMONICS 


This appendix contains a table of correspondences 
of the mne- 
monics used by the assembler in appendix B with those described in 
Z80-Assembly Language Programming Manual, 3.0DS 
REL 2.1 
(Zilog, Inc. 1977), and a short description of the function of each in- 
struction and its effect on the flags. The terms used in instruction op- 
erands have the following meanings: 


The Assembly Scheme column contains the description of the suc- 
cessive words of the instruction, 
separated by commas. The symbol 
V has the meaning Inclusive OR. Numbers in this column are all hex- 
adecimal. 
The assembly scheme for MOV 
r1r2, for example,is 
40V8r1Vr2, 
meaning the logical sum of 4016, 8 times the value of r1, 
and the value of r2. The register values are: 


B-0 
C -1 
D-2 
E -3 
H-4 
L -5 
A-7 


The symbols in the flag setting column, labeled SZAVNC, have 
the following meanings: 


Blank in this column means that all flags are unchanged 
by the 
instruction. 
The column headed Zilog name/page 
gives the equivalent mne- 
monic in Z80-Assembly Language Programming Manual 3.0 DS 
REL 2.1, and the page in the Zilog manual on which the description 
of this instruction is to be found. 
In all columns a parenthesized quantity means the contents of the 
memory address pointed to by that quantity, i.e., (HL) means the 
contents of the memory location whose address is in HL. 


458 
PRACTICAL MICROCOMPUTER PROGRAMMING 


mnemonic 
assembly/scheme 
SZAVNC 
Zilogname 
/ 
page 
ACI 
n 
CE,n 
XXXXO 
X ADC 
A,S 
108 
ADC 
M 
8E 
XXXXO 
X ADC 
A,(HL) 
108 
ADC 
r 
88Vr 
XXXXO 
X ADC 
A,S 
108 
ADCX 
d 
DD,8E,d 
XXXXO 
X ADC 
A,(IX+d) 
108 
ADCY 
d 
FD,8E,d 
XXXXO 
X ADC 
A,(IY+d) 
108 
ADD 
M 
86 
XXXXO 
X ADD 
A,(HL) 
103 
ADD 
r 
80Vr 
XXXXO 
X ADD 
A,r 
100 
ADDX 
d 
DD,86,d 
XXXXO 
X ADD 
A,(IX+d) 
104 
ADDY 
d 
FD,86,d 
XXXXO 
X ADD 
A,(IY+d) 
106 
ADI 
n 
C6,n 
XXXXO 
X ADD 
A,n 
102 
ANA 
M 
A6 
XX1XOO 
AND 
(HL) 
114 
ANA 
r 
50Vr 
XX1XOO 
AND 
r 
114 
ANI 
n 
E6,n 
XX1XOO 
AND 
n 
114 
ANX 
d 
DD,A6,d 
XX1XOO 
AND 
(IX+d) 
114 
ANY 
d 
FD,A6,d 
XXI 
XO 0 
AND 
(IY+d) 
114 
ARM 
CB,2E 
XXO XO X SRA 
(HL) 
192 
ARM X 
d 
DD,CB,D,2E 
XXO XO X SRA 
(IX+d) 
192 
ARMY 
d 
FD,CB,D,2E 
XXO XO X SRA 
(IY+d) 
192 
ARr 
CB,28Vr 
XXO XO X SRA 
r 
192 
BC 
aa 
38,aa-PC 
JR 
C,e 
224 
BCM 
b 
CB,46V8b 
RES 
b,(HL) 
217 
BCMX 
d,b 
DD,CB,d,46V8b 
RES 
b,(IX+d) 
217 
BCMY 
d,b 
FD,BC,d,46V8b 
RES 
b,(lY+d) 
217 
BCr 
b 
CB,80V8bVr 
RES 
b,r 
217 
BEQ 
aa 
28,aa-PC 
JR 
Z,e 
228 
BGE 
aa 
30,aa-PC 
JR 
NC,e 
226 
BLS 
aa 
38,aa-PC 
JR 
C,e 
224 
BNE 
aa 
2O,aa-PC 
JR 
NC,e 
230 
BNZ 
aa 
2O,aa-PC 
JR 
NZ,e 
230 
BRA 
aa 
18,aa-PC 
JR 
e 
223 
BSM 
b 
CB,C6V8b 
SET 
b,(HL) 
212 
BSMX 
d,b 
DD,CB,d,C6V8b 
SET 
b,(IX+d) 
213 
BSMY 
d,b 
FD,CB,d,C6V8b 
SET 
b,(IY+d) 
215 
BSr 
b 
CB,COV8bVr 
SET 
b,r 
211 
BTM 
b 
CB,46V8b 
? Xl 
? 0 - 
BIT 
b,(HL) 
205 
BTMX 
d,b 
DD,CB,d,46V8b 
?X1?0- 
BIT 
b,(IX+d) 
207 
BTMY 
d,b 
FD,CB,d,46V8b 
?X1?0- 
BIT 
b,(IY+d) 
209 


instruction description 
Add immediate data n and previous carry to A 
Add (HL) and previous carry to A 
Add r and previous carry to A 
Add (X+d) and previous carry to A 
Add (Y+d) and previous carry to A 
Add (HL) to A 
Add register r to A, sum in A 
Add (X+d) to A 
Add (Y+d) to A 
Add immediate data n to A 
AND (HL) with A 
AND register r with A 
AND immediate data n with A 
AND (X+d) with A 
AND (Y+d) with A 
Arithmetic right shift (HL) 
Arithmetic right shift (X+d) 
Arithmetic right shift (Y+d) 
Arithmetic right shift register r 
Branch if carry to address aa 
Clear bit b of (HL) 
Clear bit b of (X+d) 
Clear bit b of (Y+d) 
Clear bit b of register r 
Branch if equal to address aa 
Branch if greater than or equal to address aa (unsigned) 
Branch if less to address aa (unsigned) 
Branch if not equal to address aa 
Branch if not zero to address aa 
Branch to address aa unconditionally 
Set bit b of (HL) 
Set bit b of (X+d) 
Set bit b of (Y+d) 
Set bit b of register r 
Test bit b of (HL) 
Test bit b of (X+d) 
Test bit b of (Y+d) 
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mnemonic 
assembly/scheme 
S Z A V N C Zilog name 
/ 
page 
BTr 
b 
CB,4OV8bVr 
? Xl? 
O- 
BIT 
b,r 
203 
BZ 
aa 
28,aa-PC 
JR 
Z,e 
228 
CALL 
aa 
CD,la,ha 
CALL 
nn 
238 
CC 
aa 
DC,la,ha 
CALL 
cc,nn 
240 
CEQ 
aa 
CC,la,ha 
CALL 
cc,nn 
240 
CGE 
aa 
D4,la,ha 
CALL 
cc,nn 
240 
CLS 
aa 
DC,la,ha 
CALL 
cc,nn 
240 
CM 
FC,la,ha 
CALL 
cc,nn 
240 
CMA 
2F 
--1-1- 
CPL 
134 
CMC 
3F 
----OX 
CCF 
137 
CMP 
M 
BE 
XXXXI 
X CP 
(HL) 
120 
CMP 
r 
B8Vr 
XXXXI 
X CP 
s 
120 
CMPX 
d 
DD,BE,d 
XXXXI 
X CP 
(IX+d) 
120 
CMPY 
d 
FD,BE,d 
XXXXI 
X CP 
(IY+d) 
120 
CNC 
aa 
D4,la,ha 
CALL 
cc,nn 
240 
CNE 
C4,la,ha 
CALL 
cc,nn 
240 
CNV 
E4,la,ha 
CALL 
cc,nn 
240 
CNZ 
C4,la,ha 
CALL 
cC,nn 
240 
CP 
F4,la,ha 
CALL 
cc,nn 
240 
CPE 
EC,la,ha 
CALL 
cC,nn 
240 
CPI 
n 
FE,n 
XXXXI 
X CP 
n 
120 
CPO 
E4,la,ha 
CALL 
cc,nn 
240 
CV 
EC,la,ha 
CALL 
cc,nn 
240 
CZ 
aa 
CC,la,ha 
CALL 
cc,nn 
240 
CP- 
ED,A9 
XXXXI 
- 
CPD 
95 
CP-R 
ED,B9 
XXXXI 
- 
CPDR 
97 


CP+ 
ED,A1 
XXXXI 
- 
CPI 
91 
CP+R 
ED,B2 
XXXXI 
- 
CPIR 
93 


C< 
aa 
FC,la,ha 
CALL 
cc,nn 
240 
C>= 
aa 
F4,la,ha 
CALL 
cc,nn 
240 
DAA 
. 27 
XXXX- 
X DAA 
132 
DAC 
B 
ED,4A 
XXXXO 
X ADC 
HL,ss 
149 
DAC 
D 
ED,5A 
XXXXO 
X ADC 
HL,ss 
149 
DAC 
H 
ED,6A 
XXXXO 
X ADC 
HL,ss 
149 
DAC 
SP 
ED,7A 
XXXXO 
X ADC 
HL,ss 
149 


instruction description 
Test bit b of register r 
Branch if zero to address aa 
Unconditional call to address aa 
Call address aa if carry 
Call address aa if equal 
Call address aa if greater than or equal (unsigned) 
Call address aa if less (unsigned) 
Call address aa if minus 
Logical complement A (one's complement) 
Logical complement carry bit 
Compare A to (HL) 
Compare A to register r 
Compare A to (X+d) 
Compare A to (Y+d) 
Call address aa if no carry 
Call address aa if not equal 
Call address aa if no overflow 
Call address aa if not zero 
Call address aa if plus 
Call address aa if parity even 
Compare A to immediate data n 
Call address aa if parity odd 
Call address aa if overflow 
Call address aa if zero 
Compare A to (HL), decrement HL and BC, set flags 
Compare A to (HL), decrement HL and BC, stop if BC = 0 or 
equal compare 
Compare A to (HL), increment HL, decrement BC, set flags 
Compare A to (HL), increment HL, decrement BC, stop if BC = 0 or 
equal compare 
Call address aa if less (signed) 
Call address aa if greater than or equal (signed) 
Decimal adjust A register after BCD addition or subtraction 
Add BC and previous carry to HL 
Add DE and previous carry to HL 
Add HL and previous carry to HL 
Add stack pointer and previous carry to HL 


mnemonic 
assembly/scheme 
SZAVNC 
Zilogname 
/ 
page 
DAD 
B 
09 
- - X- 0 X ADD 
HL,ss 
147 
DAD 
D 
19 
- - X- 0 X ADD 
HL,ss 
147 
DAD 
H 
29 
- - X- 0 X ADD 
HL,ss 
147 
DAD 
SP 
39 
- - X- 0 X ADD 
HL,ss 
147 
DBNZ 
aa 
1O,aa-PC 
DJNZ 
e 
235 
DCMX 
d 
DD,35,d 
XXXXI 
- 
DEC 
(IX+d) 
129 
DCMY 
d 
FD,35,d 
XXXXI 
- 
DEC 
(IY+d) 
129 
DCR 
M 
35 
XXXXI 
- 
DEC 
(HL) 
129 
DCR 
r 
05V8r 
XXXXI 
- 
DEC 
r 
129 
DCX 
B 
OB 
DEC 
ss 
160 
DCX 
D 
1B 
DEC 
ss 
160 
DCX 
H 
2B 
DEC 
ss 
160 
DCX 
SP 
3B 
DEC 
ss 
160 
DCX 
X 
DD,2B 
DEC 
IX 
161 
DCX 
Y 
FD,2B 
FEC 
IY 
162 
DI 
F3 
DI 
141 
DSC 
B 
ED,42 
XXXXI 
X SBC 
HL,ss 
151 
DSC 
D 
ED,52 
XXXXI 
X SBC 
HL,ss 
151 
DSC 
H 
ED,62 
XXXXI 
X SBC 
HL,ss 
151 
DSC 
SP 
ED,72 
XXXXI 
X SBC 
HL,ss 
151 
EI 
FB 
EI 
142 
EXX 
D9 
EXX 
79 
HLT 
76 
HALT 
140 
IMO 
ED,46 
1M 
0 
143 
IMI 
ED,56 
1M 
1 
144 
1M2 
ED,5E 
1M 
2 
145 
IN 
n 
DB,n 
IN 
A,(n) 
253 
INMX 
d 
DD,34,d 
XXXXO 
- 
INC 
(IX+d) 
125 
INMY 
d 
FD,34,d 
XXXXO 
- 
INC 
(IY+d) 
127 
INr 
ED,4OV8r 
XXO XO- 
IN 
r,(C) 
254 
INR 
M 
34 
XXXXO 
- 
INC 
(HL) 
124 
INR 
r 
04V8r 
XXXXO 
- 
INC 
r 
122 
INX 
B 
03 
INC 
ss 
157 
INX 
D 
13 
INC 
ss 
157 
INX 
H 
23 
INC 
ss 
157 
INX 
SP 
33 
INC 
ss 
157 
INX 
X 
DD,23 
INC 
IX 
158 


instmction 
description 
AddBCto 
HL 
AddDEtoHL 
Add HL to itself 
Add the stack pointer to HL 
Decrement B and branch to address aa if B not zero 
Decrement (X+d) 
Decrement (Y+d) 
Decrement (HL) 
Decrement register r 
Decrement BC 
Decrement DE 
Decrement HL 
Decrement the stack pointer 
Decrement X 
Decrement Y 
Disable the interrupt system 
Subtract BC and previous borrow from HL 
Subtract DE and previous borrow from HL 
Subtract HL and previous borrow from HL 
Subtract stack pointer and previous borrow from HL 
Enable the interrupt system 
Swap BC, DE and HL with BC', DE' and HL' 
Halt 
Enter interrupt mode 0 
Enter interrupt mode 1 
Enter interrupt mode 2 
Input to A from device n 
Increment (X+d) 
Increment (Y+ d) 
Input to register r from address in C 
Increment (HL) 
Increment register r 
Increment BC 
Increment DE 
Increment HL 
Increment the stack pointer 
Increment X 
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mnemonic 
assembly/scheme 
SZAVNC. 
Zilogname 
/ 
page 
INX 
Y 
FD,23 
INC 
IY 
159 
IN+ 
ED,AZ 
? X? ? 1 - 
INI 
256 
IN+R 
ED,B2 
?1??1- 
INIR 
258 
IN- 
ED,AA 
? X? ? 1 - 
IND 
260 
IN-R 
ED,BA 
?1??1- 
INDR 
262 
JC 
aa 
DA,la,ha 
JP 
cc,nn 
221 
JEQ 
aa 
CA,la,ha 
JP 
cc,nn 
221 
JGE 
aa 
D2,la,ha 
JP 
cc,nn 
221 
JLS 
aa 
DA,la,ha 
JP 
cc,nn 
221 
JM 
aa 
FA,la,ha 
JP 
cc,nn 
221 
JMP 
aa 
C3,la,ha 
JP 
nn 
220 
JNC 
aa 
D2,la,ha 
JP 
cc,nn 
221 
JNE 
aa 
C2,la,ha 
JP 
cc,nn 
221 
JNV 
aa 
E2,la,ha 
JP 
cc,nn 
221 
JNZ 
aa 
C2,la,ha 
JP 
cC,nn 
221 
JP 
aa 
F2,la,ha 
JP 
cc,nn 
221 
JPE 
aa 
EA,la,ha 
JP 
cc,nn 
221 
JPO 
aa 
E2,la,ha 
JP 
cc,nn 
221 
JV 
aa 
EA,la,ha 
JP 
cc,nn 
221 
JZ 
aa 
CA,la,ha 
JP 
cc,nn 
221 
J< 
aa 
FA,la,ha 
JP 
cc,nn 
221 
J>= 
aa 
F2,la,ha 
JP 
cc,nn 
221 
LBCD 
aa 
ED,4B,la,ha 
LD 
dd,(nn) 
57 
LDA 
aa 
3A,la,ha 
LD 
A,(nn) 
44 
LDAX 
B 
OA 
LD 
A,(BC) 
42 
LDAX 
D 
lA 
LD 
A,(DE) 
43 
LDED 
aa 
ED,5B,la,ha 
LD 
dd,(nn) 
57 
LHLD 
aa 
2A,la,ha 
LD 
HL,(nn) 
56 
LLM 
CB,26 
XXO XO X SLA 
(HL) . 
189 
LLMX 
d 
DD,CB,d,26 
XXO XO X SLA 
(IX+d) 
189 
LLMY 
d 
FD,CB,d,26 
XXO XO X SLA 
(IY+d) 
190 
LLr 
CB,20Vr 
XXO XO X SLA 
r 
189 
LRM 
CB,3E 
XXO XO X SRL 
(HL) 
195 
LRMX 
d 
DD,CB,d,3E 
XXO XO X SRL 
(IX+d) 
195 
LRMY 
d 
FD,CB,d,3E 
XXO XO X SRL 
(lY+d) 
196 
LRr 
CB,38Vr 
XXO XO X SRL 
r 
195 
LrX 
d 
DD,46V8r,d 
LD 
r,(IX+d) 
30 


instruction description 
Increment Y 
Input from address in C, store in (HL), increment HL, decrement B 
Same as IN + above, and repeat if B not zero 
Input from address in C, store in (HL), decrement HL and B 
Same as in IN- above, and repeat if B not zero 
Jump if carry to address aa 
Jump if equal to address aa 
Jump if greater than or equal to address aa (unsigned) 
Jump if less to address aa (unsigned) 
Jump if minus to address aa 
Jump to address aa unconditionally 
Jump if no carry to address aa 
Jump if not equal to address aa 
Jump if no overflow to address aa 
Jump if not zero to address aa 
Jump if plus to address aa 
Jump if parity even to address aa 
Jump if parity odd to address aa 
Jump if overflow to address aa 
Jump if zero to address aa 
Jump if less to address aa (signed) 
Jump if greater than or equal to address aa (signed) 
Load BC from aa, aa +1 
Load A from address aa 
Load A from (BC) 
Load A from (DE) 
Load DE from aa, aa+l 
Load HL from aa, aa +1 
Logical left shift (HL) 
Logical left shift (X+d) 
Logical left shift (Y+d) 
Logical left shift register r 
Logical right shift (HL) 
Logical right shift (X+d) 
Logical right shift (Y+d) 
Logical right shift register r 
Load r from (X+d) 
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mnemonic 
assembly/scheme 
SZAVNC 
Zilogname 
/ 
page 
LrY 
d 
FD,46V8r,d 
LD 
r,(IY+d) 
32 
LSPD 
aa 
ED,7B,la,ha 
LD 
dd,(nn) 
57 
LXD 
aa 
DD,2A,la,ha 
LD 
IX,(nn) 
59 
LXI 
B,nn 01,ln,hn 
LD 
dd,nn 
53 
LXI 
D,nn 
11,ln,hn 
LD 
dd,nn 
53 
LXI 
H,nn 21,ln,hn 
LD 
dd,im 
53 
LXI 
SP,nn31,ln,hn 
LD 
dd,nn 
53 
LXI 
X,nn DD,21,ln;hn 
LD 
IX,nn 
54 
LXI 
Y,nn FD,21,ln,hn 
LD 
IY,nn 
55 
LYD 
aa 
FD,2A,la,ha 
LD 
IY,(nn) 
60 
MOV 
M,r 
70Vr 
LD 
(HL),r 
34 
MOV 
r,M 
46V8r 
LD 
r,(HL) 
29 
MOV 
r"r2 
4OV8r,Vr2 
LD 
r,r' 
27 
MVI 
M,n 
36,n 
LD 
(HL),n 
39 
MVI 
r,n 
6V8r,n 
LD 
r,n 
28 
MW+ 
ED,AO 
- - 0 Xo - 
LDI 
83 


MW+R 
ED,BO 
- - 000- 
LDIR 
85 


MW- 
ED,A8 
- - 0 XO - 
LDD 
87 
MW-R 
ED,B8 
- - 000- 
LDDR 
89 
NEG 
ED,44 
XXXXI 
X NEG 
135 
NOP 
00 
NOP 
139 
ORA 
M 
B6 
XXO XO 0 
OR 
(HL) 
116 
ORA 
r 
BOVr 
XXO XO 0 
OR 
r 
116 
ORI 
n 
F6,n 
XXO XO 0 
OR 
n 
116 
ORX 
d 
DD,B6,d 
XXO XO 0 
OR 
(IX+d) 
116 
ORY 
d 
FD,B6,d 
XXO XO O· OR 
(IY+d) 
116 
OTr 
ED,41V8r 
OUT 
(C),r 
265 
OUT 
n 
D3,n 
OUT 
(n),A 
264 
OUT+ 
ED,A3 
? X? ? 1 - 
OUTI 
267 
OT+R 
ED,B3 
?1??1- 
OTIR 
269 
OUT- 
ED,AB 
? X? ? 1 - 
OUTO 
271 
OT-R 
EO,BB 
?,1??1- 
OTOR 
273 
PCHL 
E9 
lP 
(HL) 
232 
PCX 
DO,E9 
lP 
(IX) 
233 
PCY 
FO,E9 
lP 
(IY) 
234 


instruction 
description 
Load r from (Y+d) 
Load the stack pointer from aa, aa +1 
Load X from aa, aa + 1 
Load BC with immediate data nn 
Load DE with immediate data nn 
Load HL with immediate data nn 
Load the stack pointer with immediate data nn 
Load X with immediate data nn 
Load Y with immediate data nn 
Load Y from aa, aa +1 
Store register r at (HL) 
Move data from (HL) to register r 
Move data from r2to r. 
Move immediate data n to (HL) 
Move immediate data n to register r 
Move word, increment HL and DE, decrement BC, OV on if BC 
not zero 
Move word, increment HL and DE, decrement BC, repeat if BC 
not 0 
Move word, decrement HL, DE and BC, OV on if BC not 0 
Move word, decrement HL, DE and BC, repeat if BC not zero 
Negate (two's complement) A 
No operation 
OR (HL) with A 
OR register r with A 
OR immediate data n with A 
OR (X+d) with A 
OR (Y+d) with A 
Output register r to address in C 
Output A register to device address n 
Output from (HL) to address in C, increment HL and decrement B 
Same as OUT + and repeat if B not zero 
Output from (HL) to address in C, decrement HL and B 
Same as OUT- above and repeat if B not zero 
Load program counter from HL 
Load program counter from X 
Load program counter from Y 
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mnemonic 
assembly/schemeSZAVNC 
.Zilogname 
/ 
page 
POP 
B 
Cl 
POP 
qq 
72 
POP 
D 
Dl 
POP 
qq 
72 
POP 
H 
El 
POP 
qq 
72 
POP 
PSW 
Fl 
? ? ? ? ? ? 
POP 
qq 
72 
POP 
X 
DD,El 
POP 
IX 
74 
POP 
Y 
FD,El 
POP 
IY 
75 
PUSH 
B 
C5 
PUSH 
qq 
69 
PUSH 
D 
D5 
PUSH 
qq 
69 
PUSH 
H 
E5 
PUSH 
qq 
69 
PUSH 
PSW 
F5 
PUSH 
qq 
69 
PUSH 
X 
DD,E5 
PUSH 
IX 
70 
PUSH 
Y 
FD,E5 
PUSH 
Y 
71 
RAL 
17 
- - 0 - 0 X RLCA 
166 
RAL$ 
CB,17 
XXO 
XO X RL 
A 
180 
RAR 
IF 
- - 0 - 0 X RRA 
170 
RAR$ 
CB,IF 
XXO 
XO X RR 
A 
186 
RC 
D8 
RET 
cc 
244 
REQ 
C8 
RET 
cc 
244 
RET 
C9 
RET 
243 
RETI 
ED,4D 
RETI 
246 
RETN 
ED,45 
RETN 
248 
ROE 
DO 
RET 
cc 
244 
RM 
F8 
RET 
cc 
244 
RML 
CB,16 
XXO 
XO X RL 
(HL) 
180 
RMLX 
d 
DD,CB,d,16 
XXO 
XO X RL 
(IX+d) 
180 
RMLY 
d 
FD,CB,d,16 
XXO 
XO X RL 
(IY+d) 
180 
RMR 
CB,lE 
XXO 
XO X RR 
(HL) 
186 
RMRX 
d 
DD,CB,d,IE 
XXO 
XO X RR 
(IX+d) 
186 
RMRY 
d 
FD,CB,d,IE 
XXO 
XO X RR 
(IY+d) 
187 
RNC 
DO 
RET 
cc 
244 
RNE 
CO 
RET 
cc 
244 
RNV 
EO 
RET 
cc 
244 
RNZ 
CO 
RET 
cc 
244 
RP 
FO 
RET 
cc 
244 
RPE 
E8 
RET 
cc 
244 
RPO 
EO 
RET 
cc 
244 
RLC 
07 
- - 0 - 0 X RLCA 
164 


instruction description 
Pops top stack item into BC 
Pops top stack item into DE 
Pops top stack item into HL 
Pops top stack item into AF 
Pops top stack item into X 
Pops top stack item into Y 
Pushes BC onto the stack 
Pushes DE onto the stack 
Pushes HL onto the stack 
Pushes AF onto the stack 
Push X onto the stack 
Push Y onto the stack 
Rotate A left, 9 bits 
Rotate A left, 9 bits (Z80 only) 
Rotate A right, 9 bits 
Rotate A right, 9 bits (Z80 only) 
Return if carry 
Return if equal 
Return unconditionally 
Return from interrupt 
Return from nonmaskable interrupt 
Return if greater than or equal (unsigned) 
Return if minus 
Rotate (HL) left, 9 bits 
Rotate (X+d) left, 9 bits 
Rotate (Y+ d) left, 9 bits 
Rotate (HL) right, 9 bits 
Rotate (X+d) right, 9 bits 
Rotate (Y+d) right, 9 bits 
Return if no carry 
Return if not equal 
Return if no overflow 
Return if not zero 
Return if plus 
Return if parity even 
RetUrn if parity odd 
Rotate A left, 8 bits 
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mnemonic 
assembly/scheme 
S ZAVNC 
Zilog name 
/ 
page 
RLD 
ED,6F 
XXO XO- 
RLD 
198 
RLCM 
CB,06 
XXO XO X RLC 
(HL) 
174 
RLCr 
CB,r 
XXO XO X RLC 
r 
172 
RLCX 
d 
DD,CB,d,06 
XXO XO X RLC 
(IX+d) 
176 
RLCY 
d 
FD,CB,d,06 
XXO XO X RLC' 
(IY+d) 
178 
RLS 
D8 
RET 
cc 
244 
RRC 
OF 
- - 0 - 0 X RRCA 
168 
RRCM 
CB,OE 
XXO XO X RRC 
(HL) 
183 
RRCr 
CB,8Vr 
XXO XO X RRC 
r 
183 
RRCX 
d 
DD,CB,d,OE 
XXO XO X RRC 
(IX+d) 
183 
RRCY 
d 
FD,CB,d,OE 
XXO XO X RRC 
(IY+d) 
184 
RRD 
ED,67 
XXO XO- 
RRD 
200 
RrL 
CB,lOVr 
XXO XO X RL 
r 
180 
RrR 
CB,18Vr 
XXO XO X RR 
r 
186 
RSC 
B7 
XXO XO 0 
OR 
A 
116 
RST 
t 
C7V8t 
RST 
p. 
250 
RV 
E8 
RET 
cc 
244 
RZ 
C8 
RET 
cc 
244 
R< 
F8 
RET 
cc 
244 
R>= 
FO 
RET 
cc 
244 
SBB 
M 
9E 
XXXXI 
X SBC 
A,(HL) 
112 
SBB 
r 
98Vr 
XXXXI 
X SBC 
A,r 
112 
SBCD 
aa 
ED,43,la,ha 
LD 
(nn),dd 
62 
SBCX 
d 
DD,9E,d 
XXXXI 
X SBC 
A,(IX+d) 
112 
SBCY 
d 
FD,9E,d 
XXXXI 
X SBC 
A,(IY+d) 
112 
SBI 
n 
DE,n 
XXXXI 
X SBC 
A,n 
112 
SDED 
aa 
ED,63,la,ha 
LD 
(nn),dd 
62 
SHLD 
aa 
22,la,ha 
LD 
(nn),dd 
61 
SIX 
d,n 
DD,36,d,n 
LD 
(IX+d),n 
40 
SlY 
d,n 
FD,36,d,n 
LD 
IY+d),n 
41 
SPHL 
F9 
LD 
SP,HL 
66 
SPX 
DD,F9 
LD 
SP,IX 
67 
SPY 
FD,F9 
LD 
SP,IY 
68 
SrX 
d 
DD,70Vr,d 
LD 
(IX+d),r 
35 
SrY 
d 
FD,70Vr,d 
LD 
(IY+d),r 
37 
SSPD 
aa 
ED,73,la,ha 
LD 
(nn),dd 
62 
STA 
aa 
32,la,ha 
LD 
(nn),A 
47 


instruction description 
Rotate left decimal 
Rotate (HL) left, 8 bits 
Rotate register r left, 8 bits 
Rotate (X+d) left, 8 bits 
Rotate (Y+d) left, 8 bits 
Return if less (unsigned) 
Rotate A right, 8 bits 
Rotate (HL) right, 8 bits 
Rotate register r right, 8 bits 
Rotate (X+d) right, 8 bits 
Rotate (Y+d) right, 8 bits 
Rotate right decimal 
Rotate register r left, 9 bits 
Rotate register r right, 9 bits 
Zero carry bit. Synonym for ORA 
A 
Restart 
Return if overflow 
Return if zero 
Return if less (signed) 
Return if greater than or equal (signed) 
Subtract (HL) and previous borrow from A 
Subtract register r and previous borrow from A 
Store Be in aa, aa + 1 
Subtract (X+d) and previous borrow from A 
Subtract (Y+d) and previous borrow from A 
Subtract immediate data n and previous borrow from A 
Store DE in aa, aa +1 
Store HL in aa, aa + 1 
Store immediate data n a (X+d) 
Store immediate data n at (Y+d) 
Load the stack pointer from HL 
Load the stack pointer from X 
Load the stack pointer from Y 
Store register r at (X+d) 
Store register rat (Y+d) 
Store the stack pointer in aa, aa +1 
Store A in address aa 
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mnemonic 
assembly/scheme 
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/ 
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STAX 
B 
02 
LD 
(BC),A 
45 
STAX 
D 
12 
LD 
(DE),A 
46 
STC 
37 
--0-01 
SCF 
138 
SUB 
M 
96 
XXXXIX 
SUB 
(HL) 
110 
SUB 
r 
80Vr 
XXXXIX 
SUB 
s 
110 
SUBX 
d 
DD,96,d 
XXXXIX 
SUB 
(IX+d) 
110 
SUBY 
d 
FD,96,d 
XXXXIX 
SUB 
(IY+d) 
110 
SUI 
n 
D6,n 
XXXXIX 
SUB 
n 
110 
SYD 
aa 
FD,22,la,ha 
LD 
(nn),IY 
65 
SXD 
aa 
DD,22,la,ha 
LD 
(nn),IX 
64 
TAl 
ED,57 
XXO XO- 
LD 
A,I 
48 
TAR 
ED,5F 
XXO XO- 
LD 
A,R 
49 
TIA 
ED,47 
LD 
I,A 
50 
TRA 
ED,4F 
LD 
R,A 
51 
TRP 
t 
C7V8t 
RST 
p 
250 
XAF 
08 
EX 
AF,AF' 
78 
XCHG 
EB 
EX 
DE,HL 
77 
XRA 
M 
AE 
XXO XO 0 
XOR 
(HL) 
118 
XRA 
r 
A8Vr 
XXO XO 0 
XOR 
r 
118 
XRI 
n 
EE,n 
XXO XO 0 
XOR 
n 
118 
XRX 
d 
DD,AE,d 
XXO XO 0 
XOR 
(IX+d) 
118 
XRY 
d 
FD,AE,d 
XXO XO 0 
XOR 
(IY+d) 
118 
XTHL 
E3 
EX 
(SP),HL 
80 
XTX 
DD,E3 
EX 
(SP),IX 
81 
XTY 
FD,E3 
EX 
(SP),IY 
82 
X+BC 
DD,09 
- - X- 0 X ADD 
IX,pp 
153 
X+DE 
DD,19 
- - X- 0 X ADD 
IX,pp 
153 
X+SP 
DD,39 
- - X- 0 X ADD 
IX,pp 
153 
X+X 
DD,29 
- - X- 0 X 
ADD 
IX,pp 
153 
Y+BC 
FD,09 
- - X- 0 X 
ADD 
IX,IT 
155 
Y+DE 
FD,19 
- - X- 0 X 
ADD 
IY,rr 
155 
Y+SP 
FD,39 
- - X- 0 X 
ADD 
IY,rr 
155 
Y+Y 
FD,29 
- - X- 0 X 
ADD 
IY,rr 
155 
ZAR 
AF 
o 1 0 XO 0 
XOR 
A 
118 


instruction description 
Store A in (BC) 
Store A in (DE) 
Set carry bit to 1 
Subtract (HL) from A 
Subtract register r from A, difference in A 
Subtract (X+d) from A 
Subtract (Y+d) from A 
Subtract immediate data n from A 
Store Y in aa, aa +1 
Store X in aa, aa +1 
Transfer IVR to A 
Transfer R register to A 
Transfer A to IVR 
Transfer A to R register 
Restart 
Swap AF and AF' 
Swap contents of HL and DE register pairs 
Exclusive OR (HL) with A 
Exclusive OR register r with A 
Exclusive OR immediate data n with A 
Exclusive OR (X+d) with A 
Exclusive OR (Y+d) with A 
Swap top stack item with HL 
Swap top stack item with X 
Swap top stack item with Y 
AddBCtoX 
Add DE to X 
Add the stack pointer to X 
Add X to itself 
AddBCtoY 
Add DE to Y 
Add the stack pointer to Y 
Add Y to itself 
Zero A register and carry bit. Synonym for XRA 
A 


ORG 
Assemble code which follows beginning at location given in 
operand 
field of ORG. Anything in ORG operand must 
have been previously defined. 


TITL 
Operand field of TITL will be used as heading for each page 
of the assembly listing. 


DATA 
Creates one or more single word constants 
separated 
by 
commas. The data types are: 


Decimal - 
purely numeric field, sign optional; 


Octal- 
preceded by "at" 
sign (@); 


Hexadecimal- 
preceded by colon (:); 


Symbolic - 
consisting of a defined symbol or sum or dif- 
ference of symbols and/or 
numbers whose value can 
be contained in 8 bits; 


ASCII - 
a single character enclosed by apostrophes. 


DBL 
Creates a 16 bit constant equal to the value of the operand 
field. Data types are the same as for DATA above. 


RES 
Reserves a block of memory equal in length to the value of 
the first operand. 
The label, if any, attaches to the first 
word of this block, the one with the lowest memory address. 
The second operand, separated by a comma may be any 8 
bit constant. If the second operand is given the block will be 
filled with its value by the loader. Anything in the operand 
of RES must have been previously defined. 


EQU 
Sets the value of the label to that of the operand. 
Any- 
thing in the operand of an EQU must have been previously 
defined. 


REM 
Aligns its own comments field with that of the comment 
field of an instruction. 
This allows the comment of the in- 
struction to be continued immediately below, aligned for 
easy reading. The REM itself does not appear in the assem- 
bly listing. 


INDEX 


ACI,85 
ADC, 82 
ADCX,82 
ADCY,82 
ADI,85 
Add/subtract 
flag, 79 
Address, 28 
AND, 15,16 
ANX,99-101 
ANY, 99-101 
Arguments, 146 
addresses in line, 154 
addresses in register, 150 
inline,147 
Arrays, 162 
ASC,163 
ASCII codes, 209-210 
Assembler 
definition of, 33 
error checks, 324 
error flags, 36 
location counter, 322 
object record types, 325,326 
symbol table, 321 
Assembly program, 33 
listing, 34 
Auxiliary Carry Flag, 79 


BC,66 
BCD, 182 
addition, 183-186 
division, 192-195 
multiplication, 
186-192 
shifting, 188,189 
subtraction, 
186-188 
BCM,263 
BCMX, 263,264 
BCr,263 
BEQ,107 
BGE, 107 


Binary addition, 19-22 
program, 32 
subtraction, 22 
Binary division, 127-133 
Binary multiplication, 
117 
by special number, 113-116 
signed,118-120 
Binary patch, 313-315 
Bit manipulation, 
262-264 
Block move instruction, 70-77 
BLS,107 
BNC,66 
BNE,107 
BNZ,66 
Borrow, use of, 84 
BRA, 66,67 
Breakpointing, 307 
BSM,263 
BSMY,263 
BSr,262 
BSS,74-76 
BTM,262 
BTMX,263 
BTr,262 
Bubble sort, 174-177 
Busy flag, 200 
BZ,66 


CALL, 142 
Calling sequence, 147 
Carry, 19,20 
Carry, use of, 81 
Carry flag, 79 
CC,160 
CEQ,16O 
CGE,161 
Checksum, 298 
CLS, 161 
CM,16O 
CMA,110 


CMP,103 
CMPX, 103-104 
CMPY, 103-104 
CNC,160 
CNE,160 
CNV,160 
CNZ,160 
Comment field, 35 
Complementation, 
17,18 
Control function, 197 
Control port, 197 
Conversion, 211-234 
binary to decimal fraction, 231-233 
binary to decimal integer, 220-230 
binary to hexadecimal, 234 
binary to octal, 234 
decimal to binary integer, 214-219 
CP,16O 
CPE,160 
CPI,I04 
CPO, 160 
CP+, 165,166 
CP+R, 
166-168 
CV,160 
CZ,160 
C<,161 
C>=,161 


DAA,183 
DAC,86 
DAD, 86 
DATA, 37 
Data port, 197 
Data transfer, 197 
input, 286-289 
output, 289-292 
under interrupt control, 286-292 
DBL,56,62 
DBNZ,68,69 
DCMX,282 
DCMY,282 
DCX,65 
DCY,65 
Debug program 
description, 297-316 
F function, 302 


I function, 303 
J function, 315 
M function, 299-301,315 
o function, 303 
R function, 303-306 
S function, 302 
/ function, 315 
Device address, 197 
DI,278 
Divide Fault, 128 
Dividend, 127,128 
Displacement 
of indexed instruction, 60,61 
Divisor, 127,128 
DSC,87 


Echo input, 206,207 
EI,278,285,286 
Entry point, 143 
EQU,39,61 
Exclusive OR, 16,17 
EXX,131 


FIFO Stack, 73 
Fixed point, 90 
Flag bits, 30 
Flags, 78-79 
Floating point 
addition, 238-241 
bias, 236 
conversion, 247-249 
exponent, 235,236 
fraction, 235,236 
noisy mode, 245 
normalized, 236 
overflow, 241 
precision loss, 243-245 
sign, 235,236 
true hexadecimal exponent, 246 
underflow, 241 
unnormalized, 236 
Frequency plot, 250 


Half add, 20 
Hertzsprung-Russell 
diagram, 264-275 
Hexadecimal, 2,11 
Histogram, 250 


Image region, 257 
Immediate mode, 63 
IMO,279 
IMl,279 
1M2, 280 
Inclusive OR, 13 
Index register, 60,61 
INR,65 
Instruction, 29 
execution cycle, 29 
field, 34 
register, 29 
Interface, 196 
Interrupt Vector Register, 280 
Interrupts, 276-296 
arming, 278 
disablement, 278 
disarming, 278-279 
enablement, 278 
sequence of events, 277 
INX,65 
INY,65 


JC,68 
JEQ,107 
JGE,107 
JLS,107 
JM,68 
JMP,70 
JNC,68 
JNE,107 
JNV,68 
JNZ,68 
JP,68 
JPE,70 
JPO,70 
JV,68 
JZ,68 
J<,107 
J> =, 107 


Label field, 35 
rules for, 40 
LBCD,55 
LDA,54,55 
LDAX,59 


LDED,55 
LHLD,55 
LLM,93 
LLMX,93 
LLMY,93 
Load, 54 
Logical difference, 16 
Logical product, 15 
Logical sum, 15 
Looping, 67,68 
LRM,93 
LRMX,93 
LRMY,93 
LrX,60 
LrY,60 
LSPD,135 
LXD,55 
LXI, 63 
LYD,55 


Masking, 16 
MOV,57,58 
Move, 54 
Multiple precision, 81 
addition, 81-84,87 
division, 134 
multiplication, 
133 
negation, 111 
shifts, 94-98 
subtraction, 
84,88 
MVI,63 
MW+R,70 


NEG,110 
Negation, 22-26 
Nonmaskable Interrupt, 293 


Object program, 34 
Octal, 10 
One's complement, 18 
Operand field, 35 
ORA, 98,99 
ORG,36 
ORX,99-101 
ORY,99-101 
Overflow, 24-26 
Overflow/parity 
flag, 79 


PCHL,141 
PCX,141 
PCY,141 
Pointer, 56,57 
Polling, 280 
POP, 137 
Powers of 2, 8 
Program counter, 29 
Pseudo operation, 37 
Pseudo registers, 303-306 
PUSH, 136 


Radix deflation method, 247-249 
RAL$,92 
RAR$,92 
RC,16O 
Real Time Clock, 282 
Real Time executive, 292,293 
Reentrancy, 294 
Registers, 30,31 
REM, 50 
Remainder, 128 
REQ,160 
RES, 74-76 
Restart instruction, 279 
effective address, 279 
RET,142 
RETI,293 
RETN, 293 
RGE,161 
RLC,91 
RLCM,92 
RLD, 188,189 
RLS, 161 
RM,16O 
RNC,160 
RNE,160 
RNV,160 
RNZ,16O 
RP,160 
RPE,16O 
RPO, 160 
RRC,91 
RRCM,92 


RRCX,92 
RRD,188,189 
RrL,92 
RrR,92 
RSC,50 
RST,296 
RV,16O 
RZ,160 
R<,161 
R>=,161 


SHCD,55 
SHI,85 
Scale factor, 89 
in multiplication, 
127 
SDED,55 
Sense function, 197 
Shifting, 18,19 
SHLD,55 
Sign flag, 78 
SIX, 282 
SlY, 282 
Source program, 34 
buffer, 41 
SrX, 60 
SrY,60 
SSPD,135 
STA,54,55 
Stack pointer, 31,135 
STAX, 59 
Store, 54 
Subroutine, 
143 
SUI, 85 
SXD,55 
SYD,55 


Tables, 162 
TAI,280 
TCA,I11 
Text editor, 41-53 
TIA,280 
TITL,53 
TRP,296 
Tho's complement system, 22-26 


VdUUllY 
l:Ufo:l:K.,~J~ 
Vectored Interrupt, 281 


Word, 27 
length, 28 


XAF,138 
XRA,98,99 
XRX,99-101 
XRY,99-101 
XTHL,14O 
XTX,14O 
XTY,14O 
X+SP,14O 
X+X,121 
X-V plot, 257-2b1 


To receive 
object 
code 
of the assembler 
and debug 
programs 
. . . 
Fill out both parts of the coupon 
on the facing 
page and send it to: 
Northern 
Technology 
Books 
Box 62 
Evanston, 
II 60204 
Please print or type all information. 
The lower part of the coupon 
will 
be used as your mailing label.,. 


Disclaimer 
Though 
the cassettes 
and paper tapes 
are prepared 
under stringent 
quality control, 
the great variability 
of physical 
parameters 
such as read 
head alignment makes it impossible to guarantee that they will be readable 
on any particular 
computer 
system. 
The cassettes 
and paper tapes are 
therefore 
supplied with no warranty, express or implied, as to their suitabil- 
ity for use with any particular 
computer 
system, and the user so agrees 
by the return of the coupon. 
While 
the assembler 
and debug 
programs 
and all examples 
in the 
text 
have been 
prepared 
with all prudent 
caution 
and care 
and 
have 
been 
subjected 
to extensive 
testing 
under 
diverse 
conditions, 
neither 
they nor any other computer 
program 
can be certified 
to be completely 
error free. 
Northern 
Technology 
Books 
assumes 
no liability 
for either 
the function 
of the programs 
or any direct 
or indirect 
damage 
which 
may occur as a consequence 
of their use, and the user of the programs 
so agrees by the purchase 
of this book. 


